Conversation threads in traces

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.

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.

{
  "thread": {
  "id": "<unique-thread-id>",
    "tags": ["tag1", "tag2"]
  }
}

AI Gateway

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"] }
}'

AI Gateway Thread Management

Full API reference for attaching threads to AI Gateway Deployment and Agent invocations.

Overview

Instrument your app

Explore

Monitor

Export

Review

Data privacy & security

Framework integrations

Viewing Threads

Adding a Generation to a Thread

AI Gateway Thread Management

​Viewing Threads

​Adding a Generation to a Thread

AI Gateway Thread Management

Viewing Threads

Adding a Generation to a Thread