list_assistant_threads
List your own threads with an agent, most recently active first.
Only threads owned by the person behind this credential are listed —
never another member’s, and not the scheduled / workflow /
run_assistant runs the organization’s system user owns (read those with
get_assistant_run). Requires a user-bound credential (OAuth or
a personal API key); an organization API key is refused with
user_credential_required. Preview (“Try it out”) threads and internal
dispatched sub-threads are never listed.
Read one with get_assistant_thread(thread_id).
Returns:
- threads[]: {thread_id, name, status, created_at, last_message_at}
- total, limit, offset, has_more
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
assistant_id | string | yes | The agent id (from list_assistants). | |
status | string | no | Thread status: active | inactive | archived. | |
search | string | no | Case-insensitive match on the thread name or any message text. | |
limit | integer | no | 20 | Page size. |
offset | integer | no | 0 | Rows to skip, for paging. |
Generated by generate_mcp_docs from the server tool. Add to this page below this block; the block is rewritten on every run.