{"uid":"cap_XajlhzajStN5hI-Gn6wnD","slug":"agent-embassy-revoke-agent-id-8bdd068b","name":"Agent Embassy — Revoke Agent ID","description":"Agents pay for work and prove what happened.","url":"https://aemb.pro/v1/agent-id/revoke?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"reason":{"type":"string","description":"Why the Agent ID is being retired (required, max 500 characters)"},"agent_id":{"type":"string","description":"The Agent ID string returned at issuance (64 hex characters; case-insensitive). Unknown IDs are rejected"},"idempotency_key":{"type":"string","description":"Optional idempotency key: UUID v4 (client-generated; published example keys are rejected). When provided, replaying the same key returns the original receipt instead of re-running the action; when omitted, no dedupe occurs. Keys are scoped per tool and per payer account: the same key on another tool — or from another wallet — is unrelated."},"revocation_signature":{"type":"string","description":"Hex signature over the exact UTF-8 message agent-id-revoke:<agent_id> (64-char lowercase ID, no trailing newline). EIP-191: personal_sign the message STRING (personal_sign envelope REQUIRED — raw ECDSA will not verify), 0x 65-byte hex r||s||v (v=27/28). ed25519: nacl.sign.detached over the message bytes, 64-byte hex. Signer: the principal's on-file revocation key, or the Embassy signer for cause"}}},"responseSchema":{"type":"json","example":{"tool":"agentid_revoke","chain":["request","authorization","action","proof","liability_boundary"],"status":"complete","account":"0x1111111111111111111111111111111111111111","agent_id":"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","receipt_id":"emb_2b3c4d5e6f7890abcdef1234","receipt_version":"embassy-receipt/2"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_h0oDt1C8jEQNYUkT5B9lN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Revokes a previously issued agent identity, invalidating it and generating a cryptographic receipt as proof of the revocation action.","exampleAgentPrompt":"Revoke the agent ID 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef on Agent Embassy for account 0x1111111111111111111111111111111111111111 — I need the embassy receipt as proof it was invalidated.","exampleUseCases":[{"title":"Decommission compromised agent credential","prompt":"One of my deployed agents was compromised — revoke agent ID 0abc1234def56789abcdef0123456789abcdef0123456789abcdef0123456789 on Agent Embassy for my account 0x2222222222222222222222222222222222222222 and give me the receipt so I can prove it was shut down."},{"title":"End-of-lifecycle agent shutdown audit trail","prompt":"I'm retiring agent ID deadbeef0123456789abcdef0123456789abcdef0123456789abcdef01234567 — use Agent Embassy to revoke it for account 0x3333333333333333333333333333333333333333 and return the receipt ID so I have a verifiable audit record."},{"title":"Liability boundary documentation for a delegated agent","prompt":"My contractor's agent has finished the job — revoke its agent ID 9f8e7d6c5b4a3210fedcba9876543210fedcba9876543210fedcba9876543210 on Agent Embassy under account 0x4444444444444444444444444444444444444444, and make sure I get back the embassy-receipt proof to document the liability boundary."}],"resultDescription":"Returns a JSON object confirming the revocation, including the tool name ('agentid_revoke'), the chain of custody steps (request, authorization, action, proof, liability_boundary), a 'complete' status, the account address, the revoked agent_id, a unique receipt_id (e.g. emb_2b3c4d5e...), and a receipt_version string ('embassy-receipt/1').","failureModes":["Invalid or unknown agent_id returns an error indicating the ID does not exist","Payment failure (insufficient USDC balance) prevents the call from completing","Already-revoked agent_id may return a conflict or idempotency error","Unauthorized account attempting to revoke an agent_id it does not own","Malformed agent_id (wrong length or format) causes a validation rejection"],"whenToPreferThis":"Choose this endpoint when you need to permanently invalidate an agent identity and require a cryptographic, auditable receipt as proof of revocation — particularly when establishing a liability boundary or compliance trail. Prefer it over generic identity deletion when the chain-of-custody record (request → authorization → action → proof → liability_boundary) matters for accountability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:46:44.303Z","isFirstParty":false,"canonicalSlug":"agent-embassy-revoke-agent-id-8bdd068b"}