Agent BrainsAgent Brains
APIConversations

List conversation messages

Read structured messages using a cursor scoped to the tenant and conversation. Required scope: `conversations:read`.

GET
/conversations/{id}/messages
x-api-key<token>

Preferred authentication header.

In: header

Path Parameters

id*string

Conversation ID from an event or existing conversation record.

Match^[a-fA-F0-9]{24}$
Length24 <= length <= 24

Query Parameters

cursor?string

Use next_cursor from the previous response. Omit for the first page. URL-encode the value.

Length1 <= length <= 1024
limit?integer

Maximum items per page. Defaults to 50; accepted range is 1–100.

Default50
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.agent-brains.com/conversations/stringstringstringstring/messages"
{
  "items": [
    {
      "id": "string",
      "conversation_id": "string",
      "body": "string",
      "direction": "incoming",
      "sender": {
        "type": "customer",
        "external_id": "string"
      },
      "created_at": "2019-08-24T14:15:22Z",
      "sequence": 1,
      "client_message_id": "string",
      "delivery_status": "pending"
    }
  ],
  "next_cursor": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}