API Reference

Agent DID issuance

Provision a delegated agent identity bound to your institutional principal. Each agent DID carries scoped capability claims and is on-chain revocable. Per PRD §12.8: every action a Hundi-issued agent takes is auditable to the human principal who delegated it.

Request

POST /v1/agents
Authorization: Bearer <jwt>
X-Idempotency-Key: 6f0b1-77c3-...

{
  "principal_did":  "did:hundi:0xa12c...",
  "label":          "Treasury copilot — APAC",
  "capabilities": [
    { "scope": "quotes.read",    "ceiling_usd": "100000000.00" },
    { "scope": "quotes.accept",  "ceiling_usd": "5000000.00" },
    { "scope": "transactions.read" }
  ],
  "expires_at": "2026-08-06T00:00:00.000Z"
}

Response

{
  "agent_did":      "did:hundi:agent:0x7b3e...",
  "principal_did":  "did:hundi:0xa12c...",
  "capabilities": [
    { "scope": "quotes.read",    "ceiling_usd": "100000000.00" },
    { "scope": "quotes.accept",  "ceiling_usd": "5000000.00" },
    { "scope": "transactions.read" }
  ],
  "issued_at":  "2026-05-06T12:00:00.247Z",
  "expires_at": "2026-08-06T00:00:00.000Z",
  "revocation_endpoint": "https://api.hundi.network/v1/agents/did:hundi:agent:0x7b3e.../revoke"
}

Revocation is on-chain and propagates to the Trust Registry within 5.2s p99. A revoked agent cannot accept quotes; in-flight quotes by that agent are voided.