Skip to main content
POST
Create automation run

Authorizations

Authorization
string
header
required

Raw dev token passed as Authorization: Bearer fabro_dev_... when server.auth.methods includes dev-token.

Path Parameters

id
string
required

Unique automation identifier.

Pattern: ^[a-z0-9][a-z0-9-]{0,62}$

Response

Run created

Canonical public run shape.

id
string
required
children_count
integer<uint64>
required

Number of runs currently linked to this run as their orchestration parent.

Required range: x >= 0
title
string
required
goal
string
required
workflow
object
required
automation
object | null
required
repository
object | null
required

Durable repository metadata for a run.

created_by
object
required
origin
object
required
labels
object
required
lifecycle
object
required
sandbox
object | null
required

Sandbox lifecycle record for a run. A run can have a requested sandbox plan before it has an initialized sandbox instance.

models
object[]
required
source_directory
string | null
required
timestamps
object
required
timing
object | null
required

Run-level timing rollup. Wall time is the run's clock duration; active timing sums work across stage visits.

billing
object | null
required
size
enum<string>
required

Run size bucket derived from current best-effort billed usage.

Available options:
XS,
S,
M,
L,
XL
ask_fabro
object
required

Readiness and defaults for starting an Ask Fabro session on this run.

diff
object | null
required

Cheap aggregate file and line counts for a run diff.

pull_request
object | null
required

Minimal GitHub pull request link associated with a run.

current_question
object | null
required

A pending human-in-the-loop question summary.

superseded_by
string | null
required

Run ID that superseded this run via rewind, if any.

retried_from
string | null
required

Source run ID when this run was created by manual retry.

parent_id
string | null

Current orchestration parent run ID, if linked.