GET /v2/runs/{run_id}
Get one of the organization's runs with its full payload.
How to use
Poll this after creation and inspect data.status. A 200 response can describe a failed run. The input/output may be null, and logging controls can block detail reads. pending_input is only exposed when the caller can both read and resume the run.
Authentication and permissions
Required permissions: analytics.read. Resource and owner access checks also apply.
Personal API key (sk_...) or supported user access JWT. See Authentication and authorization for endpoint restrictions and scopes. Use exactly one Authorization header.
Successful Response
Machine-readable response code, when provided.
Invalid run ID.
Authentication required.
Analytics read permission required or run logging disabled.
Run not found.
Validation Error
curl --fail-with-body -sS \
"$STACKAI_BASE_URL/v2/runs/${RUN_ID}" \
-H "Authorization: Bearer $STACKAI_API_KEY"{
"data": {
"run_id": "5f4c3b2a-1111-4111-8111-123456789abc",
"project_id": "YOUR_PROJECT_ID",
"project_version": 1,
"status": "running",
"error": null,
"created_at": "2026-10-05T12:00:00Z",
"started_at": "2026-10-05T12:00:01Z",
"completed_at": null,
"run_type": "api",
"created_by": null,
"usage": {
"total_tokens": 0,
"details": []
},
"parent_run_id": null,
"parent_project_id": null,
"input": {
"in-0": "Summarize our refund policy"
},
"output": null,
"citations": null,
"pending_input": null
}
}Last updated
Was this helpful?

