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

# Conversation threads in traces

> Group related LLM calls into threads for observability and analysis. Threads are a labeling mechanism and do not store or inject message history.

See [HTTP URLs and authentication](/docs/reference/base-urls.md) and the API reference for complete request and response formats.

Threads group related [AI Gateway](/docs/ai-gateway/using-the-router.md) calls into a single conversation view, letting you trace multi-turn interactions across your Deployments and Agents.

## Viewing Threads

Open **Threads** in the **Observability** section of the sidebar. Each row is one thread:

| Column | Shows |
| - | - |
| **Timestamp** | When the thread was last updated. |
| **Project** | The project the thread belongs to. |
| **Title** | The thread title. |
| **ID** | The external id recorded for the thread. |
| **Tags** | The tags attached to the thread. |
| **Total Cost** | The cost of every trace in the thread. |
| **Total Tokens** | The tokens of every trace in the thread. |
| **# of Traces** | How many traces the thread groups. |

The range button reads **30 days** by default. **Filter** narrows the list by **Kind**, **Conversation** or **Coding agent**, and by **Tags**. Read the same list through the API with [List trace threads](/docs/reference/threads/list-trace-threads.md).

By selecting a **Thread**, you can then visualize the conversation.

Deployment

## Adding a Generation to a Thread

**Threads** group related AI Gateway requests. Pass a thread ID to the Responses API to associate each generation with the same conversation.

The API receives the following extra parameter:

> Conversations will be grouped by Thread ID
>
> Tags can be used to filter and search Threads in the panel.

```json JSON theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "thread": {
  "id": "<unique-thread-id>",
    "tags": ["tag1", "tag2"]
  }
}
```

> [tab] AI Gateway
>
> ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl --request POST \
> --url 'https://router.toqan.ai/eu/v3/router/responses' \
> -H 'Authorization: Bearer <insert Toqan API key>' \
> -H 'Content-Type: application/json' \
> --data '{
>   "model": "openai/gpt-4.1-mini",
>   "input": "Hello!",
>   "thread": { "id": "<unique-thread-id>", "tags": ["tag1", "tag2"] }
> }'
> ```

> [card] [AI Gateway Thread Management](/docs/ai-gateway/thread-management.md)
>
> Full API reference for attaching threads to **AI Gateway** Deployment and Agent invocations.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.