Skip to main content
POST
Create Run

Authorizations

Authorization
string
header
required

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

Body

application/json

A request to create, but not start, one run from an immutable workflow version and an explicit workspace target.

workflow_version_id
string
required

SHA-256 identity of validated canonical workflow-version bytes. Hex input is case-insensitive; Fabro emits the canonical lowercase form.

Pattern: ^[0-9A-Fa-f]{64}$
Example:

"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"

target
object
required

Workspace content and location requested for a run.

args
object
required

Structured run overrides accepted by workflow-version creation.

environment_id
string

Server environment catalog ID. Omission selects default.

parent_id
string

Optional orchestration parent run ID.

title
string

Optional explicit run title, normalized by the server.

Maximum string length: 100
goal
string

Optional inline goal override.

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.

usage
object
required

The run's usage summed across every stage visit so far: the conclusion's total once the run ended, else the sum of the stages'.

size
enum<string>
required

Run size bucket derived from the run's current cost.

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.