Create a thread

curl --request POST \
  --url https://api.usepatchwork.co/v1/loom/threads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "status": "success",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "agent": {
      "name": "<string>"
    },
    "subject_ref": "<string>"
  }
}

{
  "status": "error",
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

{
  "status": "error",
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

POST

loom

threads

curl --request POST \
  --url https://api.usepatchwork.co/v1/loom/threads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "status": "success",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "agent": {
      "name": "<string>"
    },
    "subject_ref": "<string>"
  }
}

{
  "status": "error",
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

{
  "status": "error",
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

Authorizations

Authorization

string

header

required

Identify accepts a workspace API key (sk_…). Loom accepts either a short-lived session token (direct) or a workspace API key (relay).

Headers

Patchwork-Subject

string

Relay only. Opaque subject id for the acting user. Direct tokens carry sub instead — do not send this header on a session token.

Patchwork-Connection

string

Connection id or name the agent may call. Required in relay when the agent has unpinned customer tools. Direct tokens may carry conn instead.

Body

application/json

agent

string

Agent public id (agent_…). Defaults to the workspace's published agent.

subject_ref

string

Relay only. Acting user id. Ignored on a direct token.

Response

Thread created.

status

string

required

Allowed value: "success"

data

object

required

Show child attributes

⌘I

Core

Identify

Loom

Coming soon

Identify

Loom

Authorizations

Headers

Body

Response