Admiral
Runs

Retry a revision

POST
/api/v1/runs/{run_id}/revisions/{revision_id}/retry

Scope: run:write

Authorization

bearerAuth
AuthorizationBearer <token>

Personal Access Token (PAT) or Service Access Token (SAT). Pass the token in the Authorization header: Bearer admp_...

In: header

Path Parameters

run_id*run_id

The run. UUID or run-<suffix> display ID.

Length1 <= length
revision_id*revision_id

The revision to retry (UUID). Must be in FAILED status.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://api.admiral.io/api/v1/runs/string/revisions/497f6eca-6276-4993-bfeb-53cbbbba6f08/retry" \  -H "Content-Type: application/json" \  -d '{    "run_id": "string",    "revision_id": "f8f7f022-982b-4bef-ba7d-4bb808fdbe2a"  }'
{  "revision": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec",    "component_id": "41afafe5-2a48-424a-baef-34c2ad44ef7b",    "component_name": "string",    "kind": "REVISION_KIND_UNSPECIFIED",    "status": "REVISION_STATUS_UNSPECIFIED",    "change_type": "REVISION_CHANGE_TYPE_UNSPECIFIED",    "previous_revision_id": "string",    "source_id": "string",    "ref": "string",    "resolved_values": "string",    "depends_on": [      "string"    ],    "blocked_by": [      "string"    ],    "plan_summary": {      "creates": 0,      "updates": 0,      "deletes": 0,      "noops": 0    },    "available_phases": [      "REVISION_PHASE_UNSPECIFIED"    ],    "error_message": "string",    "retry_count": 0,    "started_at": "2023-01-15T01:30:15.01Z",    "completed_at": "2023-01-15T01:30:15.01Z",    "working_directory": "string",    "created_at": "2023-01-15T01:30:15.01Z",    "resolved_commit": "string",    "type": "string"  }}