Runs
List runs
Common filter fields: application_id, environment_id, status.
Use to view run history for an environment.
Scope: run:read
Authorization
bearerAuth AuthorizationBearer <token>
Personal Access Token (PAT) or Service Access Token (SAT). Pass the token in the Authorization header: Bearer admp_...
In: header
Query Parameters
filter?filter
Filter expression to narrow results. Uses the Admiral filter DSL (see the API documentation for the full operator and predicate reference).
Filterable fields:
application_id: runs for a specific application (UUID).environment_id: runs to a specific environment (UUID).status: filter by run status (PENDING, PLANNING, APPLYING, SUCCEEDED, ...).change_set_id: runs for a specific change set (UUID).
Example: field['environment_id'] = '<uuid>' AND field['status'] = 'SUCCEEDED'
Length
length <= 1024page_size?page_size
Maximum number of runs to return per page. Defaults to 50 when omitted or 0; must not exceed 100.
Format
int32Range
0 <= value <= 100page_token?page_token
Opaque pagination token from a previous response.
Response Body
application/json
curl -X GET "https://api.admiral.io/api/v1/runs"{ "runs": [ { "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" } ], "next_page_token": "string"}