Skip to content

Get execution status / result

GET
/workflows/executions/{execution_id}

Return execution status + output_data + token / cost telemetry.

The MCP polling pattern: call this until status reaches a TERMINAL value — completed, failed or stopped. A run can also sit in paused or pending_approval (both non-terminal and resumable via the lifecycle routes below), so a poller must treat those as “keep waiting”, not “done” — polling only for completed/failed hangs forever on a paused or approval-gated run. The full set voice writes is pending|running|completed|failed|paused|pending_approval|stopped. Voice’s GET enforces tenant isolation natively so no pre-flight is needed for the read path.

Authorizations

Parameters

Path Parameters

execution_id
required

Execution UUID.

string
>= 1 characters

Execution UUID.

Header Parameters

X-Target-Org-Id
Any of:
string

Responses

200

Successful Response

object
key
additional properties
any

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string