Update message status
POST
/v1/messages/{message_id}/statusReports a delivery status transition for a message (SENT, DELIVERED, READ, FAILED).
The caller app is identified from the OAuth access token and must own the
conversation the message belongs to — i.e. the conversation must have been
created by, or be assigned to, the same app. Calls from any other app are
rejected with 403 (messages.app-not-permitted).
Returns 400 on invalid transitions, 404 if the message is not found.
Requires chat:write scope.
Authorization
BearerAuth AuthorizationBearer <token>
In: header
Path Parameters
message_id*string
The unique identifier (UUID) of the message.
Format
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request body for updating message status from a TPA.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/messages/b0dbb0d9-9fea-4a48-9bf6-4a5e2f0db8f6/status" \ -H "Content-Type: application/json" \ -d '{ "status": "DELIVERED" }'Empty