List Delegations

List active delegations scoped to your tenant.

GET /v1/delegations

Filter by delegator_id to see which agents a user has consented to, or by delegate_id to see which users an agent is acting on behalf of.

Request

Headers

Header	Value
Authorization	Bearer azx_...

Query parameters

Name	Type	Required	Description
delegator_id	string (uuid)	No	Filter to delegations where this entity is the delegator (e.g. a user who granted consent).
delegate_id	string (uuid)	No	Filter to delegations where this entity is the delegate (e.g. an AI agent acting on behalf of a user).

Response

200 OK

{
  "data": [
    {
      "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"
    }
  ],
  "total": 1
}

Error responses

Status	Description
401	Missing or invalid API key

Example

# All delegations where John is the delegator
curl "https://api.vengtoo.com/v1/delegations?delegator_id=a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "Authorization: Bearer azx_..."