Retry Run

POST /runs/{run_id}/retry

A new attempt on the same run: the checkpoint thread continues and cost accumulates.

Role floor

Requires member or above. The floor is a minimum, not a grant: scope filtering still applies on top of it, and a resource in another tenant answers 404 rather than 403.

Parameters

Name	In	Type		Notes
run_id	path	string (uuid)	required	—

Request body — RunRetryRequest

Field	Type		Notes
reason	string | null	optional	max length 500

Responses

Status	Description	Body
202	Successful Response	RunView
422	Validation Error	HTTPValidationError

Only the success paths are declared

Any operation may also answer any status in the error catalogue, and every failure body is the platform envelope — including the 422 this document types as HTTPValidationError.

Example

curl -X POST https://your-deployment.example.com/runs/{run_id}/retry \
  -H "Authorization: Bearer $COBRE_TOKEN"

Response — RunView

Field	Type		Notes
client_tools	end | suspend	optional	Default "end".
client_tool_timeout_s	integer | null	optional	—
id	string (uuid)	required	—
status	queued | running | suspended | succeeded | failed | timed_out | cancelled	required	—
agent_id	string (uuid)	required	—
agent_revision_id	string (uuid)	required	—
persona_id	string (uuid) | null	optional	—
session_id	string (uuid) | null	required, nullable	—
parent_run_id	string (uuid) | null	required, nullable	—
root_run_id	string (uuid) | null	required, nullable	—
delegation_depth	integer	required	—
lane	string	required	—
priority	integer	required	—
trigger_kind	api | schedule | event | channel | delegation | retry | replay | maintenance | system	required	—
response_mode	async | sync | callback | ack	required	—
input	object	required	—
output	object | null	required, nullable	—
error_message	string | null	required, nullable	—
failure_class	transient | provider | tool | guardrail | budget | policy | timeout | recursion | cancelled | fatal | null	required, nullable	—
failure_detail	string | null	required, nullable	—
attempt_count	integer	required	—
max_attempts	integer	required	—
queued_at	string (date-time)	required	—
first_started_at	string (date-time) | null	required, nullable	—
completed_at	string (date-time) | null	required, nullable	—
deadline_at	string (date-time) | null	required, nullable	—
next_attempt_at	string (date-time) | null	required, nullable	—
duration_ms	integer | null	required, nullable	—
active_ms	integer	required	—
queue_ms	integer | null	required, nullable	—
phase_timings	object	required	—
usage	RunUsageView	optional	—
correlation_id	string (uuid) | null	optional	—
actor_credential_fingerprint	string | null	optional	—
actor_credential_expires_at	string (date-time) | null	optional	—
consolidation_run_id	string (uuid) | null	optional	—
persona_name	string | null	optional	—