# Update message status

URL: https://www.inclamo.com/docs/api/application/messages/update-message-status

> Updates the delivery status of a single message. Available only for messages in
API channel inboxes, where your own system is responsible for delivering messages
and reporting what happened. Use this to push `sent`, `delivered`, and `read`
receipts into Chatwoot, for example, to mark an agent's message as read when the
end user views it in your client, so the agent sees the read indicator on the
message.

A message already marked `read` cannot be moved back to `delivered`. When
reporting a failure, include `external_error` with the reason, which is shown to
the agent along with the failed indicator.


## PATCH /api/v1/accounts/{account_id}/conversations/{conversation_id}/messages/{message_id}

Update message status

Updates the delivery status of a single message. Available only for messages in
API channel inboxes, where your own system is responsible for delivering messages
and reporting what happened. Use this to push `sent`, `delivered`, and `read`
receipts into Chatwoot, for example, to mark an agent's message as read when the
end user views it in your client, so the agent sees the read indicator on the
message.

A message already marked `read` cannot be moved back to `delivered`. When
reporting a failure, include `external_error` with the reason, which is shown to
the agent along with the failed indicator.


Base URL: https://helpdesk.inclamo.com

### Parameters

- `account_id` (path, required, integer): The numeric ID of the account
- `conversation_id` (path, required, integer): The numeric ID of the conversation
- `message_id` (path, required, integer): The numeric ID of the message

### Request body

`application/json` (required)

```json

{
  "type": "object",
  "required": [
    "status"
  ],
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "sent",
        "delivered",
        "read",
        "failed"
      ],
      "description": "The new status of the message"
    },
    "external_error": {
      "type": "string",
      "description": "Error description, stored only when status is failed"
    }
  }
}

```

### Responses

- 200: Success
- 401: Unauthorized
- 403: The message does not belong to an API channel inbox
- 404: The message or conversation does not exist in the account

Schemas referenced with $ref are defined in the OpenAPI file: https://www.inclamo.com/docs/api/openapi.json
