Threads

Operations of the Interactive Session API. Paths are relative to your deployment's API host.

GET /api/agent-session-api/sessions/{id}/threads

List the conversation threads on a session

Authentication: bearer token (Authorization: Bearer <token>)

POST /api/agent-session-api/sessions/{id}/threads

Create a new conversation thread on a session

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json CreateThreadDto

GET /api/agent-session-api/sessions/{id}/threads/{threadId}

Get one conversation Thread within its Session

Authentication: bearer token (Authorization: Bearer <token>)

PATCH /api/agent-session-api/sessions/{id}/threads/{threadId}

Rename a thread or change its lifecycle status (e.g. archive)

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json UpdateThreadDto

DELETE /api/agent-session-api/sessions/{id}/threads/{threadId}

Delete a thread. Refuses to delete the session's last active thread (409).

Authentication: bearer token (Authorization: Bearer <token>)

POST /api/agent-session-api/sessions/{id}/threads/{threadId}/branches

Create a new Thread branch under the same immutable Session composition

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json BranchThreadDto

POST /api/agent-session-api/sessions/{id}/threads/{threadId}/interrupt

Interrupt the agent turn currently in flight on a thread

Authentication: bearer token (Authorization: Bearer <token>)

GET /api/agent-session-api/sessions/{id}/threads/{threadId}/messages

Get a thread's message history (cursor-paginated)

Authentication: bearer token (Authorization: Bearer <token>)

POST /api/agent-session-api/sessions/{id}/threads/{threadId}/messages

Send a message on a thread (SSE streaming response). Requires Idempotency-Key header.

Authentication: bearer token (Authorization: Bearer <token>)

GET /api/agent-session-api/sessions/{id}/threads/{threadId}/timeline

Replay-on-refresh timeline for a thread

Authentication: bearer token (Authorization: Bearer <token>)