Update an application
Scope: app:write
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
Unique identifier for the application (UUID).
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X PATCH "https://admiral.example.com/api/v1/applications/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{ "application": { "id": "a1b2c3d4-5678-9abc-def0-1234567890ab", "name": "inventory-api", "description": "Core inventory management service for tracking warehouse stock levels and fulfillment.", "labels": { "team": "logistics", "tier": "critical" }, "created_by": "d290f1ee-6c54-4b01-90e6-d701748f0851", "updated_by": "d290f1ee-6c54-4b01-90e6-d701748f0851", "created_at": "2025-09-15T10:30:00Z", "updated_at": "2025-11-02T14:22:00Z" } }'{ "application": { "id": "a1b2c3d4-5678-9abc-def0-1234567890ab", "name": "inventory-api", "description": "Core inventory management service for tracking warehouse stock levels and fulfillment.", "labels": { "team": "logistics", "tier": "critical" }, "created_by": "d290f1ee-6c54-4b01-90e6-d701748f0851", "updated_by": "d290f1ee-6c54-4b01-90e6-d701748f0851", "created_at": "2025-09-15T10:30:00Z", "updated_at": "2025-11-02T14:22:00Z" }}List applications GET
Scope: `app:read`
Create a cluster POST
The response includes a `plain_text_token` -- the raw SAT secret shown exactly once. Deploy this token to the K8s agent (e.g., via Helm values or a Kubernetes Secret). The agent uses it to authenticate with AgentAPI.RegisterAgent on first boot. Scope: `cluster:write`