Skip to main content
GET
Get a generation job

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

job_id
string<uuid>
required

Response

Successful Response

A generation job's current state. Poll this until status is terminal.

created_at
string<date-time>
required
domain
string
required

The domain this job is researching.

error
string | null
required

Why generation failed — infra trouble, or too little public content.

id
string<uuid>
required
status
enum<string>
required

Where a context-generation job has got to.

Jobs are born RUNNING — creation validates, inserts and queues the workflow in one call, so there is no separate committed-but-not-started phase. PENDING exists for schema parity with the other job enums and is never observed. The two terminal states are absorbing: a job never leaves them.

Available options:
pending,
running,
succeeded,
failed
updated_at
string<date-time>
required