Retrieve a run

Current state of a run, plus the latest assistant message when one exists.

GET /v1/loom/runs/{id}

Retrieve a run

cURL

curl --request GET \
  --url https://api.usepatchwork.co/v1/loom/runs/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "status": "success",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "terminal": true,
    "cost_credits": 123,
    "connection": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    },
    "message": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "role": "<string>",
      "content": "<string>",
      "created_at": "2023-11-07T05:31:56Z"
    }
  }
}

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.

Path Parameters

id · string<uuid> · required

Response

200

application/json

The run.

status · string · required

Allowed value: "success"

data · object · required

Show child attributes