Continue an interrupted run

Resume a Research run that stopped before all of its planned source work was complete. Use it when more capacity or another retry opportunity is available so completed artifacts stay intact and unfinished work can continue.

POST/api/v1/research/runs/{run_id}/continue

API keyAPI key with research:write

Required boundary headers

x-api-key or Authorization: BearerIdempotency-Key

Overview

What this route does

Use continuation after the run has a resumable terminal state and more capacity or retry opportunity is available. Ready artifacts are not regenerated.

Examples

Request and response

Example request

curl -X POST "https://vidbyte-backend.onrender.com/api/v1/research/runs/rrun_example/continue" \
  -H "x-api-key: $VIDBYTE_API_KEY" \
  -H "Idempotency-Key: research-continue-001"

Example response

{
  "encrypted_id": "rth_public_token",
  "run_id": "rrun_example",
  "status": "accepted"
}

Response

Response and errors

Returns 202 Accepted with stable thread and run identities.
Durable membership makes completed source work idempotent across continuation.