Skip to main content
POST
Restart a run at a task

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

run_id
string<uuid>
required

ID of the run to restart.

Body

application/json

Restart a run at one of its tasks.

from_task
integer
required

The task index to restart at. Tasks before it are seeded from what this run kept.

Required range: x >= 0

Response

Successful Response

Response returned after a crew run starts.

correlation_id
string
required

ID for the crew run.

status
enum<string>
default:pending

State of the run. Always pending here, since the run has only just started.

Available options:
pending,
running,
completed,
failed
message
string | null

Human-readable note about the run, such as which crew started.