v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-014994227.2 KB

runs

Get a run

Returns one run by ID, scoped to the caller's organization.

get/runs/{run_id}

Path parameters

run_idstring uuid required

run identifier

Response

$schemastring uri

A URL to the JSON Schema for this object.

canceled_atstring date-time

Timestamp when the run was cancelled.

completed_atstring date-time

Timestamp when the run finished.

created_atstring date-time required

Timestamp when the run record was created.

error_messagestring

Error details if the run failed.

idstring uuid required

Run identifier.

logsstring

Run's execution log output.

phone_idstring

Device executing the run.

run_metadataobject

Arbitrary metadata attached to the run.

session_idstring uuid

Session associated with this run.

start_timeout_secondsinteger

How long the queued run may wait for a phone before auto-cancel.

started_atstring date-time

Timestamp when the run began executing.

status'queued' | 'running' | 'completed' | 'failed' | 'cancelled' required

Current lifecycle state of the run.

successboolean

Whether the run completed without error.

trace_expired_atstring date-time

When the trace recording was deleted.

trigger'manual' | 'scheduled' | 'api' required

Trigger identifies how the run was initiated.

updated_atstring date-time required

Timestamp of the last update to the run record.

user_idstring uuid required

User who initiated the run.

variablesobject

Variable configuration used for the run.

video_urlstring

URL for the run recording video.

workflow_idstring uuid required

Workflow this run belongs to.

Example response

{
  "$schema": "/api/v1/RunResponse.json"
}