Sign in

v2

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-01-12412664.0 KB
Authentication

Delegate Access to Another Agent

Allow an authenticated agent to generate a temporary, scoped credential (macaroon) and delegate it to another agent for specific resources and permissions.

post/auth/delegate

Request body

target_agent_idstring required
resourcestring required
permissionsstring[] required
ttl_secondsinteger required

Time-to-live for the delegation in seconds

Example request

{
  "target_agent_id": "agent-target-1234",
  "resource": "openai-api",
  "permissions": [
    "read",
    "write"
  ],
  "ttl_seconds": 3600
}

Response

Delegation token created successfully

delegation_tokenstring

Macaroon delegation token

Example response

{
  "delegation_token": "MDAxY2xvY2F0aW9uIGh0dHA6Ly9leGFtcGxlLm9yZy8KMDAyY2lkZW50aWZpZXIg..."
}