Admiral
Agent

Report revision result

POST
/api/v1/agent/revisions/{revision_id}/result

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

Authorization

bearerAuth
AuthorizationBearer <token>

Personal Access Token (PAT) or Service Access Token (SAT). Pass the token in the Authorization header: Bearer adm_pat_...

In: header

Path Parameters

revision_id*revision_id

The revision being reported on (UUID).

Formatuuid

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/revisions/497f6eca-6276-4993-bfeb-53cbbbba6f08/result" \  -H "Content-Type: application/json" \  -d '{    "result": {}  }'
{  "ack": true}

Report cluster status POST

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`

Create an application POST

Scope: `app:write`