Read run status

Poll the typed durable status of one owned Research run.

GET/api/v1/research/runs/{run_id}

API keyAPI key with research:read

Required boundary headers

x-api-key or Authorization: Bearer

Overview

What this route does

Use this read route after an asynchronous mutation to observe status, phase, continuation count, and update time without receiving internal dispatch details.

Examples

Request and response

Example request

curl "https://vidbyte-backend.onrender.com/api/v1/research/runs/rrun_example" \
  -H "x-api-key: $VIDBYTE_API_KEY"

Example response

{
  "run_id": "rrun_example",
  "thread_id": "opaque_thread_reference",
  "status": "running",
  "phase": "discovering",
  "continuation_count": 0,
  "updated_at": "2026-08-10T12:00:00Z"
}

Response

Response and errors

Returns run_id, public thread_id, status, phase, continuation_count, and updated_at.
Owner IDs and dispatch event IDs are intentionally omitted.