Retrieves a list of your AI threads, with support for filtering and pagination.
Permission | Description |
---|---|
ai_threads.view | View your own threads |
Name | Type | Required | Description | Example |
---|---|---|---|---|
search | string | No | Search by title | "project" |
context_type | string | No | Filter by context type(s), comma-separated | "plan,post" |
context_id | string | No | Filter by context ID(s), comma-separated | "1,2,3" |
sort | string | No | Sort order: desc or asc (default desc ) | "desc" |
page | int | No | Page number for pagination | 1 |
GET /api/v1/ai/threads?search=project&sort=desc&page=1
Authorization: Bearer {token}
Returns a paginated list of AI thread resources.
{
"data": [ { /* ai thread resource */ }, ... ],
"links": { /* pagination data */ },
"meta": { /* pagination data */ }
}
For a full schema, see AI Thread Resource and Pagination Data (per page: 50).
Status | Description | Reference |
---|---|---|
401 | Unauthorized | Authentication error |
403 | Forbidden (no permission) | Permission error |