The Thread object

One conversation. Belongs to a subject. Holds messages and runs.

A thread is created against a published agent, then you post messages to it. Direct tokens only see their own threads. Relay without a subject sees the workspace.

Created:

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

Listed (summary):

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "title": "Send 50 USDC to Jane",
  "subject_ref": "user_42",
  "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_action": null,
  "created_at": "2026-08-16T11:58:00Z",
  "updated_at": "2026-08-16T12:00:00Z"
}

The first user message becomes the title (truncated). List is capped at 30, newest first.

Attributes

id · uuid · required

Unique identifier for the thread.

title · string

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

subject_ref · string

Acting user. From the token sub (direct) or Patchwork-Subject / subject_ref (relay).

agent · object

Hide properties

name · string

Display name of the published agent on this thread.

message_count · integer

Number of messages on the thread. List only.

last_message · object

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

pending_elicitation · object

Present when a run is awaiting_input.

Show properties

run_id · uuid

The paused run.

kind · string

Patch that asked the question.

prompt · object

Arguments the agent sent with the question.

pending_action · object

Present when a run is awaiting_outcome.

Show properties

run_id · uuid

The waiting run.

tool_call_id · uuid

The proposed action to resolve.

patch_ref · string

Patch that proposed the action.

args · object

Arguments the agent sent.

created_at · timestamp

When the thread was opened.

updated_at · timestamp

When the thread last changed.

Endpoints

• Create a thread — POST /v1/loom/threads
• List threads — GET /v1/loom/threads