> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aui.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Threads

> List, filter, inspect, and rename conversation threads across your organization.

The management surface gives you an organization-wide view of conversation
[threads](/api/messaging/threads) — for back-office tools, QA, and analytics.

***

## List threads

```bash cURL theme={"dark"}
curl "https://api-v3.aui.io/apollo-api/management/v1/threads?tool=create_dispute&created=2026-07-01T00:00:00Z&created=2026-07-13T00:00:00Z" \
  -H "x-organization-api-key: <org_api_key>"
```

### GET `/management/v1/threads`

Lists your organization's threads, newest first, as a [paginated
list](/api/management/projects#pagination). Filters **OR within a field and
AND across fields** — repeat a parameter to OR values:

<ParamField query="project_id" type="string">
  Filter by project.
</ParamField>

<ParamField query="agent_id" type="string">
  Filter by agent — repeatable.
</ParamField>

<ParamField query="user_id" type="string">
  Filter by end-user id.
</ParamField>

<ParamField query="created" type="string">
  RFC 3339 timestamp — repeat it twice for a `[start, end]` range.
</ParamField>

<ParamField query="tool" type="string">
  Threads where this tool was activated — repeatable.
</ParamField>

<ParamField query="rule" type="string">
  Threads where a rule was evaluated: `code`, or `code:outcome` with outcome
  one of `fired`, `blocked`, `passed`. Repeatable.
</ParamField>

<ParamField query="param" type="string">
  Threads by computed parameter: `key:value`, `key:*` (any value), or a
  comparison like `amount>100`. Repeatable.
</ParamField>

<ResponseExample>
  ```json 200 theme={"dark"}
  {
    "results": [
      { "id": "68e78d0dc5a4b19a030d03d6", "title": "Dispute a charge", "created_at": "2026-07-12T09:14:02Z" }
    ],
    "meta": { "has_more": false, "after_cursor": null, "before_cursor": null },
    "links": { "next": null, "prev": null }
  }
  ```
</ResponseExample>

***

## Get a thread

### GET `/management/v1/threads/{threadId}`

Returns one thread — its `title`, the `user_id` it belongs to, its
`welcome_message`, and current `followup_suggestions`.

## Rename a thread

### PATCH `/management/v1/threads/{threadId}`

```bash cURL theme={"dark"}
curl -X PATCH "https://api-v3.aui.io/apollo-api/management/v1/threads/{threadId}" \
  -H "Content-Type: application/json" \
  -H "x-organization-api-key: <org_api_key>" \
  -d '{ "title": "Renamed conversation" }'
```

<ParamField body="title" type="string">
  The new title. Fields you omit are left unchanged; the full updated thread
  is returned.
</ParamField>

## Read a thread's transcript

### GET `/management/v1/threads/{threadId}/messages`

The thread's full transcript, in chronological order — the same message shape
as the [messaging surface](/api/messaging/threads).

## Inspect reasoning

### GET `/management/v1/threads/{threadId}/trace`

### GET `/management/v1/interactions/{interactionId}/trace`

The reasoning [traces](/api/messaging/traces) for a whole thread or one
interaction.