Report cluster status
The cluster is identified by the service access token -- the server resolves the cluster from the SAT's binding. No cluster_id is required in the request.
This endpoint is agent-facing and restricted to service access tokens.
Scope: cluster:status | 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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://admiral.example.com/api/v1/agent/status" \ -H "Content-Type: application/json" \ -d '{ "status": {} }'{ "ack": true, "next_push_seconds": 0}Retrieve a revision bundle GET
The bundle contains pre-rendered Kubernetes manifests (from Helm template, kustomize build, or raw manifests) ready for server-side apply. The agent does not need to render anything -- it applies the bundle as-is. The cluster is identified by the service access token's binding. Returns PERMISSION_DENIED if the revision's target cluster does not match the SAT's cluster binding. Returns NOT_FOUND if the revision does not exist or has been canceled. Scope: `cluster:deploy` | Token types: `sat`
Report revision result POST
The cluster is identified by the service access token's binding. Returns PERMISSION_DENIED if the revision's target cluster does not match the SAT's cluster binding. Scope: `cluster:deploy` | Token types: `sat`