Skip to main content
GET
Get a run job (status, episodes, gates)

Authorizations

Authorization
string
header
required

Either a Supabase user access token (from a password login, or the passwordless magic-link flow) or a long-lived forge_sk_… API key. Both are sent as Authorization: Bearer <value> and resolve to the same owner, so every endpoint accepts either. Session tokens expire in ~1h; API keys do not expire and are the credential for MCP clients, CI, and partner integrations.

Path Parameters

job_id
string
required
Example:

"aug_9f8e7d6c5b4a"

Response

The job

One augmentation run job (mine → compose → render → gate). A campaign run (POST /api/workbench/campaigns/{campaign_id}/runs) creates one; poll it at GET /api/aug/jobs/{job_id} until status settles.

job_id
string
Example:

"aug_9f8e7d6c5b4a"

engine
string
dataset_id
string
status
enum<string>
Available options:
queued,
running,
succeeded,
failed,
cancelled
stage
enum<string>

Current pipeline stage.

Available options:
mine,
compose,
render,
gate,
done
error
string | null
progress
object

Monotonic counters over the run's candidates.

episodes
object[]
head_stats
object

Per-head accept/reject yield for THIS run ({head episode: {accepted, rejected}}).

created_utc
string<date-time>
updated_utc
string<date-time>