Admiral
States

Delete a state

DELETE
/api/v1/states/{state_id}

Returns NOT_FOUND if the state record does not exist. Returns FAILED_PRECONDITION if the state is currently locked.

Scope: state:admin

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

state_id*state_id

The unique identifier of the state record to delete (UUID). Fails if the state is currently locked -- force-unlock first.

Formatuuid

Response Body

application/json

curl -X DELETE "https://admiral.example.com/api/v1/states/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{}

Update a source PATCH

Scope: `source:write`

Force unlock a state POST

Returns NOT_FOUND if the state record does not exist. Returns FAILED_PRECONDITION if the state has no active lock. This action is logged in the audit trail. Scope: `state:admin`