The Thread object

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

uuid

required

Unique identifier for the thread.

string

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

string

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

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

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

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

Core

Identify

Loom

Coming soon

Identify

Loom

Attributes

Endpoints

​Attributes

​Endpoints

Attributes

Endpoints