Get Delegation

Retrieve a single delegation by ID.

GET /v1/delegations/{id}

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

{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "tenant_id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
  "delegator_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "delegate_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "description": "Allow agent to read documents on my behalf",
  "scope": ["document:read"],
  "expires_at": "2026-12-31T23:59:59Z",
  "revoked_at": null,
  "created_by": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-06-24T10:00:00Z"
}

Error responses

Status	Description
401	Missing or invalid API key
404	Delegation not found

Example

curl https://api.vengtoo.com/v1/delegations/c3d4e5f6-a7b8-9012-cdef-123456789012 \
  -H "Authorization: Bearer azx_..."