API DocsAPI Docs / GET /api/v1/ai/threads/{thread-id}/messages

GET /api/v1/ai/threads/{thread-id}/messages

Retrieves a list of messages in a specific AI thread, with support for pagination.

Permissions

URL Parameters

Query Parameters

Request Example

GET /api/v1/ai/threads/123/messages?page=1
Authorization: Bearer {token}

Response

200 OK

Returns a paginated list of AI thread message resources.

Ordered newest first, by created_at descending and then by id descending. The second key is not cosmetic: created_at has one-second resolution, so a user message and the assistant reply it triggers routinely share a timestamp, and id is what puts them in the order they were written.

Only user and assistant messages are returned. The system rows the engine writes (the thread's instruction prompt and every tool result) are internal and never listed.

Example

{
  "data": [ { /* ai thread message resource */ }, ... ],
  "links": { /* pagination data */ },
  "meta": { /* pagination data */ }
}

For a full schema, see AI Thread Message Resource and Pagination Data (per page: 100).

Error Responses