Revoke Delegation
Revoke an active delegation by ID.
DELETE /v1/delegations/{id}
Once revoked, the delegate immediately loses the delegator's permission scope. The next authorization check reflects the change with no propagation delay.
Request
Headers
| Header | Value |
|---|---|
Authorization | Bearer azx_... |
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string (uuid) | Yes | The delegation ID returned by Create Delegation. |
Response
200 OK
{
"status": "revoked"
}
Error responses
| Status | Description |
|---|---|
401 | Missing or invalid API key |
404 | Delegation not found or already revoked |
Example
curl -X DELETE https://api.vengtoo.com/v1/delegations/c3d4e5f6-a7b8-9012-cdef-123456789012 \
-H "Authorization: Bearer azx_..."