Admiral
Environments

List environments

GET
/api/v1/environments

Scope: env: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: filter by parent application (UUID).
  • name: filter by environment name.
  • labels.key: filter by label key.

Example: field['application_id'] = '<uuid>' AND field['name'] = 'prod'

Lengthlength <= 1024
page_size?page_size

Maximum number of environments to return per page. Defaults to 50 when omitted or 0; must not exceed 100.

Formatint32
Range0 <= value <= 100
page_token?page_token

Opaque pagination token from a previous response.

Response Body

application/json

curl -X GET "https://api.admiral.io/api/v1/environments"
{  "environments": [    {      "id": "e5f6a7b8-9012-3cde-f456-789012345678",      "application_id": "a1b2c3d4-5678-9abc-def0-1234567890ab",      "name": "staging",      "description": "Shared staging environment for QA validation before production promotion.",      "labels": {        "region": "us-east-1",        "tier": "staging"      },      "has_pending_changes": true,      "last_deployed_at": "2025-11-01T09:15:00Z",      "created_by": {        "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",        "display_name": "Alex Chen",        "email": "[email protected]"      },      "created_at": "2025-09-15T11:00:00Z",      "updated_at": "2025-11-02T14:30:00Z"    }  ],  "next_page_token": "string"}

List components deployed to an environment GET

Components without a SUCCEEDED revision (e.g. CREATE entries that failed mid-plan) still appear, with `last_revision_status` and `last_deployed_at` empty. Scope: `env:read`

List variables for an environment GET

Sensitive variable values are masked in the response. Scope: `var:read`