The Thread object

A thread is created against a published agent, then you post messages to it. Threads are partitioned by subject: a direct token sees its own, and a relay caller sees the subject it names in Patchwork-Subject. A call that names no subject is refused. Created:

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "agent": { "name": "Amber" },
  "subject_ref": "user_9f2:ws_acme"
}

Listed (summary):

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "title": "Send 50 USDC to Jane",
  "subject_ref": "user_9f2:ws_acme",
  "agent": { "name": "Amber" },
  "message_count": 4,
  "last_message": {
    "role": "assistant",
    "content": "I need Jane's account number.",
    "created_at": "2026-08-16T12:00:00Z"
  },
  "pending_elicitation": null,
  "pending_confirmation": null,
  "pending_action": null,
  "created_at": "2026-08-16T11:58:00Z",
  "updated_at": "2026-08-16T12:00:00Z"
}

The first user message becomes the title (truncated). Listing returns the newest threads first and is cursor-paginated — 25 per page by default.

Attributes

uuid

required

Unique identifier for the thread.

string

Conversation title. Defaults to "New conversation" until the first message.

string

The subject that owns this thread. From the token sub (direct) or Patchwork-Subject / subject_ref (relay). Opaque to Patchwork.

object

Hide properties

string

Display name of the published agent on this thread.

integer

Number of messages on the thread. List only.

object

Most recent message, content truncated to 120 characters. List only.

object

Present when a run is awaiting_input.

Show properties

uuid

The paused run.

string

Patch that asked the question.

object

Arguments the agent sent with the question.

object

Set when a write is held at an approval gate. Carries the tool_call_id you pass to POST /v1/loom/runs/:run_id/confirm, plus a summary and risk for your approval UI. See Confirmations.

object

Present when a run is awaiting_outcome.

Show properties

uuid

The waiting run.

uuid

The proposed action to resolve.

string

Patch that proposed the action.

object

Arguments the agent sent.

timestamp

When the thread was opened.

timestamp

When the thread last changed.

Endpoints

POST /v1/loom/threads — create a thread
GET /v1/loom/threads — list threads, with the pending_* fields

Core

Conversations

Configuration

Delivery

MCP

Workbench

Attributes

Endpoints

​Attributes

​Endpoints

Attributes

Endpoints