List Threads
status field that is one of pending, completed, or failed.
When a thread’s status is failed, the response includes an error field containing a human-readable message describing the failure reason. The error field is omitted for threads that are not in a failed state.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The API version to use for this request. The latest version is 2026-03-11.
2026-03-11 Path Parameters
The ID of the agent. Use a UUID for custom agents or notion_ai for Notion Agent (personal agent); the reserved UUID 33333333-3333-3333-3333-333333333333 remains supported for backward compatibility.
Query Parameters
Filter threads by ID (exact match).
Filter threads by title (case-insensitive substring match).
Filter threads by status.
pending, requires_action, completed, failed Filter threads by agent activity state. Defaults to all.
all, pending, in_progress, failed, success Filter threads by one or more creator IDs. Use "me" for the API bot and user associated with the API token.
1 - 100 elementsFilter threads by one or more IDs of actors who last used them. Use "me" for the API bot and user associated with the API token.
1 - 100 elementsTimestamp used to sort threads. Defaults to created_time.
created_time, last_used_time Sort direction. Defaults to descending.
ascending, descending If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.
The number of items from the full list desired in the response. Maximum: 100
1 <= x <= 100