Admiral
Runs

Retry a revision

POST
/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

Response Body

application/json

curl -X POST "https://example.com/v1/runs/string/revisions/497f6eca-6276-4993-bfeb-53cbbbba6f08/retry"
{  "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"  }}

List runs GET

Common filter fields: `application_id`, `environment_id`, `status`. Use to view run history for an environment. Scope: `run:read`

Fetch current Terraform state GET

Returns the current `.tfstate` document for the component+environment, or 204 when no state exists yet. Maps to the Terraform HTTP backend GET. Authenticate with a PAT/SAT (HTTP Basic password or Bearer token); requires the `state:read` scope.