Threads - AUI

The management surface gives you an organization-wide view of conversation threads — for back-office tools, QA, and analytics.

List threads

cURL

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. Filters OR within a field and AND across fields — repeat a parameter to OR values:

project_id

string

Filter by project.

agent_id

string

Filter by agent — repeatable.

user_id

string

Filter by end-user id.

created

string

RFC 3339 timestamp — repeat it twice for a [start, end] range.

tool

string

Threads where this tool was activated — repeatable.

rule

string

Threads where a rule was evaluated: code, or code:outcome with outcome one of fired, blocked, passed. Repeatable.

param

string

Threads by computed parameter: key:value, key:* (any value), or a comparison like amount>100. Repeatable.

{
  "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 }
}

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}`

cURL

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

title

string

The new title. Fields you omit are left unchanged; the full updated thread is returned.

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.

Inspect reasoning

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

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

The reasoning traces for a whole thread or one interaction.

​List threads

​GET /management/v1/threads

​Get a thread

​GET /management/v1/threads/{threadId}

​Rename a thread

​PATCH /management/v1/threads/{threadId}

​Read a thread’s transcript

​GET /management/v1/threads/{threadId}/messages

​Inspect reasoning

​GET /management/v1/threads/{threadId}/trace

​GET /management/v1/interactions/{interactionId}/trace

List threads

GET `/management/v1/threads`

Get a thread

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

Rename a thread

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

Read a thread’s transcript

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

Inspect reasoning

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

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