Docs
Sign in

Run a failed agent again from its task branch.

Optional guidance (up to 4000 characters) is added to the next run's prompt as the founder's guidance for this attempt, after the task's instructions.

POST/api/v1/agents/{id}/retry

Scopecrews

It is recorded on the agent and on each later run (guidance, with who gave it) and stays with the agent, through automatic retries and recoveries, until a later retry replaces it. Without a body the agent keeps the guidance it had. An agent that is not failed or stopped answers 409 conflict. No query parameters.

Path parameters.

idstringrequired

The agent's id.

Headers.

Idempotency-Keystring

Makes a retry safe: the same key with the same request returns the first answer and does nothing else.

Body.

Optional: leave the body out and it is read as {}.

guidancestring

Added guidance for this attempt and every later run of this agent, in the founder's words. 1 to 4000 characters.

Response.

200 OK: a Agent. The example has placeholder values.

422 validation_failed
The body does not match its schema; each problem is in details.