Retrieve a job bundle
The bundle contains everything the runner needs to execute the Terraform operation: rendered .tf files, resolved variables, provider configuration, backend configuration, and the required Terraform version.
This endpoint is runner-facing and restricted to service access tokens.
Scope: runner:exec | Token types: sat
Authorization
bearerAuth Personal Access Token (PAT) or Service Access Token (SAT). Pass the token in the Authorization header: Bearer adm_pat_...
In: header
Path Parameters
The job to fetch the bundle for (UUID).
uuidResponse Body
application/json
curl -X GET "https://admiral.example.com/api/v1/runner/jobs/497f6eca-6276-4993-bfeb-53cbbbba6f08/bundle"{ "bundle": { "artifact_url": "string", "artifact_checksum": "string", "variables": { "property1": "string", "property2": "string" }, "provider_configs": { "property1": "string", "property2": "string" }, "backend_config": "string", "terraform_version": "string" }}Claim a job POST
The runner is identified by the service access token -- no runner_id is required. This endpoint is runner-facing and restricted to service access tokens. Scope: `runner:exec` | Token types: `sat`
Send runner heartbeat POST
The runner is identified by the service access token -- the server resolves the runner from the SAT's binding. No runner_id is required in the request. This endpoint is runner-facing and restricted to service access tokens. Scope: `runner:exec` | Token types: `sat`