For the complete documentation index, see llms.txt. This page is also available as Markdown.

GET /v2/runs/{run_id}

Get Run

get

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.

Authorizations
AuthorizationstringRequired

Personal API key (sk_...) or supported user access JWT. See Authentication and authorization for endpoint restrictions and scopes. Use exactly one Authorization header.

Path parameters
run_idstring · uuidRequired
Responses
200

Successful Response

application/json
response_codestring · nullableOptional

Machine-readable response code, when provided.

get/v2/runs/{run_id}
curl
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?