Get Run State

GET /runs/{run_id}/state

The graph’s own view: which node is next, how many visits, what it is waiting for.

Role floor

Requires viewer or above. The floor is a minimum, not a grant: scope filtering still applies on top of it, and a resource in another tenant answers 404 rather than 403.

Parameters

Name	In	Type		Notes
run_id	path	string (uuid)	required	—

Responses

Status	Description	Body
200	Successful Response	RunStateView
422	Validation Error	HTTPValidationError

Only the success paths are declared

Any operation may also answer any status in the error catalogue, and every failure body is the platform envelope — including the 422 this document types as HTTPValidationError.

Example

curl -X GET https://your-deployment.example.com/runs/{run_id}/state \
  -H "Authorization: Bearer $COBRE_TOKEN"

Response — RunStateView

Field	Type		Notes
run_id	string (uuid)	required	—
status	queued | running | suspended | succeeded | failed | timed_out | cancelled	required	—
thread_id	string	required	—
node	string | null	optional	—
visits	integer	optional	Default 0.
task	string	optional	Default "".
internal_context	object	optional	—
result	object | null	optional	—
suspension	RunSuspensionView | null	optional	—