Admiral
StateApiV1StateComponent_idEnvEnvironment_id

Fetch current Terraform state

GET
/api/v1/state/{component_id}/env/{environment_id}

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.

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

component_id*string

The infrastructure component (UUID).

Formatuuid
environment_id*string

The environment the state is scoped to (UUID).

Formatuuid

Response Body

application/json

curl -X GET "https://api.admiral.io/api/v1/state/497f6eca-6276-4993-bfeb-53cbbbba6f08/env/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{}
Empty
Empty
Empty

Update a source PATCH

Scope: `source:write`

Push Terraform state POST

Stores a new state version; the body is the full `.tfstate` document. Maps to the Terraform HTTP backend POST. Authenticate with a PAT/SAT; requires the `state:write` scope.