API-key reference

Continue an interrupted run

Resume partial, failed, or credit-exhausted work under the same durable run identity.

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.