Skip to content

Agent Runtime

GET /v1/agents/me

Return the current agent bundle for the provided AGNT_KEY.

Auth:

http
Authorization: Bearer agnt_xxx
bash
curl "https://api.agent-id.dev/v1/agents/me" \
  -H "Authorization: Bearer agnt_xxx"

Example response:

json
{
  "id": "uuid",
  "label": "customer-support",
  "agnt_key_hash": "agnt_3f41e0d6f8a1...",
  "is_active": true,
  "phone_number": {
    "id": "uuid",
    "number": "+13156200700",
    "country_iso2": "US",
    "created_at": "2026-03-13T00:00:00Z"
  },
  "email_inbox": {
    "id": "uuid",
    "address": "support@example.com",
    "created_at": "2026-03-13T00:00:00Z"
  },
  "wallet": {
    "id": "uuid",
    "provider": "privy",
    "chain": "base",
    "address": "0x...",
    "custody": "self-custodial",
    "status": "active",
    "delegated": true,
    "spend_policy": {
      "id": "uuid",
      "asset": "USDC",
      "chain": "base",
      "token_address": "0x833589fCD6EDb6E08f4c7C32D4f71b54bdA02913",
      "decimals": 6,
      "max_per_tx_atomic": "1000000",
      "max_daily_atomic": "10000000",
      "allowlisted_addresses": null
    },
    "created_at": "2026-03-13T00:00:00Z"
  },
  "created_at": "2026-03-13T00:00:00Z"
}

Notes:

  • agnt_key itself is not returned here.
  • Use this endpoint as the first runtime identity read after external provisioning hands the runtime an AGNT_KEY.
  • Optional resources remain null if SMS or wallet provisioning was skipped.

Agent-first public docs. Stable URLs, static pages, machine-readable spec.