در حال بارگذاری…
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 |