در حال بارگذاری…
Retrieves a list of messages in a specific AI thread, with support for pagination.
| Permission | Description |
|---|---|
ai_thread_messages.view | View your own thread messages |
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| thread-id | int | Yes | ID of the thread | 123 |
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| page | int | No | Page number for pagination | 1 |
GET /api/v1/ai/threads/123/messages?page=1
Authorization: Bearer {token}
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.
{
"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).
| Status | Description | Reference |
|---|---|---|
| 401 | Unauthorized | Authentication error |
| 403 | Forbidden (no permission) | Permission error |