List the messages of one of the key's conversations

curl --request GET \
  --url https://api.chattler.ai/v1/agents/{agent_id}/conversations/{conversation_id}/messages \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.chattler.ai/v1/agents/{agent_id}/conversations/{conversation_id}/messages"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.chattler.ai/v1/agents/{agent_id}/conversations/{conversation_id}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": "<string>",
      "role": "user",
      "type": "<string>",
      "content": "<string>",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "next_cursor": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

Conversations

List the messages of one of the key's conversations

Return the messages of a conversation that belongs to the authenticated API key, newest first. Only user and assistant messages are returned: tool exchanges, tool-activity rows and the system prompt are never exposed.

Authentication

Authorization: Bearer cht_live_<key_id>.<secret>; both read-only and full keys may read.

Path Parameters

agent_id: The agent the key is bound to
conversation_id: A conversation id from the conversations endpoint or a chat response. A conversation of another key or channel, or an unknown id, is conversation_not_found

Query Parameters

date_from, date_to: ISO-8601 bounds on created_at; date_to is exclusive; same UTC rules as the conversations endpoint
limit: page size, 1-100 (default 20)
cursor: the next_cursor value from the previous page

Example Request

curl -X GET "/v1/agents/{agent_id}/conversations/{conversation_id}/messages?limit=50" \
  -H "Authorization: Bearer cht_live_{key_id}.{secret}"

Response

data: array of messages, newest first, each with id, role (user or assistant), type (text, image, file, …), content (text; non-text payloads are rendered as their text or name) and created_at
next_cursor: opaque string for the next page, or null on the last page

Errors

invalid_api_key (401), agent_mismatch (403)
conversation_not_found (404): not this key’s conversation
validation_error (422): bad limit, dates, or a malformed cursor
rate_limit_exceeded (429), api_rate_limit_unavailable (503), internal_error (500)

GET

agents

{agent_id}

conversations

{conversation_id}

messages

List the messages of one of the key's conversations

curl --request GET \
  --url https://api.chattler.ai/v1/agents/{agent_id}/conversations/{conversation_id}/messages \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.chattler.ai/v1/agents/{agent_id}/conversations/{conversation_id}/messages"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.chattler.ai/v1/agents/{agent_id}/conversations/{conversation_id}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": "<string>",
      "role": "user",
      "type": "<string>",
      "content": "<string>",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "next_cursor": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Agent API key: Authorization: Bearer cht_live_<key_id>.

Path Parameters

agent_id

string

required

conversation_id

string

required

Query Parameters

date_from

string<date-time> | null

date_to

string<date-time> | null

limit

integer

default:20

Required range: 1 <= x <= 100

cursor

string | null

Response

One page of the conversation's messages plus the next cursor

data

ApiMessageItem · object[]

required

Show child attributes

next_cursor

string | null

Opaque cursor for the next page; null on the last page

API Reference

Chat

Conversations

List the messages of one of the key's conversations

Authentication

Path Parameters

Query Parameters

Example Request

Response

Errors

Authorizations

Path Parameters

Query Parameters

Response