Read runs with captured deliverable metadata

GET

/api/v1/threads/{threadId}/runs

Authorization

bearerAuth
HTTP Bearer (API key)
required
Authorization: Bearer <token>

Path parameters

threadId
string
required

Returns

200

Run projection

JSON

ok
optional
boolean
runs
optional
array of
object
- id
  optional
  string
- threadId
  optional
  string
- status
  optional
  string
- expectedDeliverables
  optional
  array of
  string
  Optional approval-frozen workspace output paths, in delivery order. Paths are unique ignoring case; relative, non-hidden ASCII segments only (letters/digits, dot, underscore, hyphen, internal spaces), no empty/dot/parent/absolute segments or leading/trailing spaces. Only md/txt/json/csv. Requested complete UTF-8 nonempty files are capped at 16384 bytes each and 65536 bytes total; JSON must parse. Collection checks do not assess semantic quality.
  
  maxLength: 240 · minLength: 1 · pattern: ^(?!.* (?:/|$))(?:[A-Za-z0-9][A-Za-z0-9._ -]*/)*[A-Za-z0-9][A-Za-z0-9._ -]*\.(?:[mM][dD]|[tT][xX][tT]|[jJ][sS][oO][nN]|[cC][sS][vV])$
- deliverables
  optional
  array of
  object
  path
  string
  required
  maxLength: 240
  mediaType
  string
  required
  bytes
  integer
  required
  maximum: 16384 · minimum: 1
  sha256
  string
  required
  pattern: ^[a-f0-9]{64}$
  artifactId
  optional
  string
  Opaque stable identity for grouping retained versions within the owning run store.
  
  pattern: ^artifact_[a-f0-9]{32}$
  version
  optional
  integer
  minimum: 1
  sourceRunId
  optional
  string
  provenance
  optional
  object
  skills
  optional
  array of
  object
  skillId
  string
  required
  version
  integer
  required
  minimum: 1
  name
  string
  required
  customAgent
  optional
  object
  id
  string
  required
  version
  integer
  required
  minimum: 1
  review
  optional
  object
  status
  pending_review
  or
  approved
  or
  changes_requested
  required
  updatedAt
  optional
  integer
  note
  optional
  string
  maxLength: 500
}