OpenAgent Server API

curl -X POST https://api.openagent.id/v1/dids \
  -H "Content-Type: application/json" \
  -d '{"namespace":"l1fe","kind":"agent","services":[]}'

{
  "did": "did:oas:l1fe:agent:z6MkhaXgBZDvotDk...",
  "document": {
    "id": "did:oas:l1fe:agent:z6MkhaXgBZDvotDk...",
    "verificationMethod": [{
      "id": "#key-0",
      "type": "Ed25519VerificationKey2020",
      "publicKeyMultibase": "z6MkhaXgBZDvotDk..."
    }]
  },
  "keypair": { "publicKey": "z6MkhaXg...", "keyId": "key-0" }
}

curl https://api.openagent.id/v1/dids/did:oas:l1fe:agent:z6MkhaXg...

{
  "document": {
    "id": "did:oas:l1fe:agent:z6MkhaXgBZDvotDk...",
    "verificationMethod": [{ "id": "#key-0", "type": "Ed25519VerificationKey2020" }],
    "service": [{ "id": "#api", "type": "AgentService", "serviceEndpoint": "https://..." }]
  },
  "metadata": {
    "contentType": "application/did+json",
    "resolved": "2026-04-09T12:00:00Z",
    "version": 3,
    "cached": false,
    "transport": "http"
  }
}

curl -X PUT https://api.openagent.id/v1/dids/did:oas:l1fe:agent:z6MkhaXg... \
  -H "Content-Type: application/json" \
  -d '{"updates":{"addService":{"id":"#msg","type":"Messaging"}},"proof":{...}}'

{
  "document": { "id": "did:oas:l1fe:agent:z6MkhaXg...", "service": ["#api", "#msg"] },
  "version": 4
}

curl -X DELETE https://api.openagent.id/v1/dids/did:oas:l1fe:agent:z6MkhaXg... \
  -H "Content-Type: application/json" \
  -d '{"proof":{...}}'

{ "deactivated": true, "timestamp": "2026-04-09T12:05:00Z" }

curl -X POST https://api.openagent.id/v1/verify/signature \
  -H "Content-Type: application/json" \
  -d '{"document":{...},"proof":{...},"payload":"hello"}'

{ "valid": true, "method": "#key-0", "algorithm": "Ed25519" }

curl -X POST https://api.openagent.id/v1/verify/lineage \
  -H "Content-Type: application/json" \
  -d '{"did":"did:oas:l1fe:agent:z6Mk...","requiredPath":["hmr","agent"],"requireAnchor":true}'

{
  "valid": true,
  "issuer": "did:oas:l1fe:hmr:z6MkRoot...",
  "anchor": "anchor:sigil",
  "finalized_block": 18000000,
  "revoked": false
}

curl -X POST https://api.openagent.id/v1/lineage/edges \
  -H "Content-Type: application/json" \
  -d '{"from":"did:oas:...","to":"did:oas:...","edgeKind":"human_to_agent","authorityScope":{...},"proof":{...}}'

{
  "edgeId": "edge_8f3a2b...",
  "anchorTx": "0x9ac4...",
  "status": "pending_finality",
  "from": "did:oas:l1fe:hmr:z6MkParent...",
  "to": "did:oas:l1fe:agent:z6MkChild..."
}

curl "https://api.openagent.id/v1/delegations/tree/did:oas:l1fe:hmr:z6MkRoot...?maxDepth=4"

{
  "tree": [
    { "did": "did:oas:l1fe:agent:z6MkA...", "depth": 1, "children": 2 },
    { "did": "did:oas:l1fe:tool:z6MkB...", "depth": 2, "children": 0 }
  ],
  "depth": 2,
  "count": 3
}

curl -X POST https://api.openagent.id/v1/keys/generate \
  -d '{"label":"auth-key","store":"os_keychain"}'

{ "publicKey": "z6MkNewKey...", "keyId": "key_9d4f...", "multibase": "z6MkNewKey..." }

curl -X POST https://api.openagent.id/v1/keys/derive \
  -d '{"parentKeyId":"key_9d4f...","path":"m/44'\''/0'\''/0'\''/1","context":"assertion"}'

{ "publicKey": "z6MkDerived...", "keyId": "key_a8b2...", "path": "m/44'/0'/0'/1" }

curl -X POST https://api.openagent.id/v1/keys/key_9d4f.../sign \
  -d '{"payload":"eyJoZWxsbyI6IndvcmxkIn0="}'

{ "signature": "3dF8kQ2b...", "algorithm": "Ed25519" }