Skip to main content
Get an owned job by id

Authorizations

Authorization
string
header
required

Authorization: Bearer stefan_sk_... (API key — bills the API wallet) or stefan_oat_... (OAuth member token — bills your plan pool).

Path Parameters

id
string<uuid>
required

Response

The durable job and its Task metadata.

Job polling envelope (status, result, and cancel responses). data carries the family payload.

object
string
Allowed value: "job"
family
string
job_id
string
chat
string | null
status
string | null

Lifted from the family payload: queued | running | succeeded | failed | cancelled; null when the family returned non-JSON text or an error.

Lifted poll hint; null when absent — poll with your default interval plus capped backoff.

data
object | null

The job payload: run_id, family, status, progress_message, progress, and error. The result endpoint adds result; the cancel endpoint adds accepted. A parked ask_stefanbrain turn (family mcp_ask) carries the ask envelope instead.

content
object[]
is_error
boolean
error
object | null

Structured failure classification; an object exactly when is_error is true, null otherwise.