Admiral
Runs

Apply a planned run

POST
/api/v1/runs/{run_id}/apply

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

Identifier of the run to apply. UUID or run-<suffix> display ID.

Length1 <= length

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/apply" \  -H "Content-Type: application/json" \  -d '{    "run_id": "string"  }'
{  "run": {    "id": "7e8f9a0b-1c2d-3e4f-5a6b-7c8d9e0f1a2b",    "display_id": "run-3k7m9p2q4rvw",    "application_id": "a1b2c3d4-5678-9abc-def0-1234567890ab",    "environment_id": "e5f6a7b8-9012-3cde-f456-789012345678",    "status": "RUN_STATUS_SUCCEEDED",    "message": "Deploy v2.4.1 with updated ingress rules",    "triggered_by": {      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",      "display_name": "Alex Chen",      "email": "[email protected]"    },    "revision_summary": {      "total": 3,      "succeeded": 3    },    "created_at": "2025-11-20T14:00:00Z",    "completed_at": "2025-11-20T14:12:00Z"  }}