Skip to main content
GET
Get a run
In the Heliyos MCP server: heliyos_runs_get.

Authorizations

Authorization
string
header
required

A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.

Path Parameters

id
string
required

The run id (runId from Ask Heliyos, or orchestratorRunId from List runs).

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9_.:@=+-]+$

Query Parameters

wait
integer

Seconds to wait for the run to finish or stop on a person, 0 to 30. Defaults to 0 (answer at once). Seconds to long-poll until the run finishes or waits on a person (0 = answer at once).

Required range: 0 <= x <= 30
include
string

Comma-separated extras: detail, step_payloads, or both (detail,step_payloads). Comma list. detail: title, surface, error, workers, toolCalls, createdAt (the run view). step_payloads: each step's raw input, output and error, and the execution graph.

Pattern: ^(detail|step_payloads)(,(detail|step_payloads))*$

Response

The run.

meta
object
required
data
object
required