# Agent Embassy — Revoke Agent ID

> Agent Embassy — Revoke Agent ID is a paid API for AI agents from aemb.pro, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-11).

Revokes a previously issued agent identity, invalidating it and generating a cryptographic receipt as proof of the revocation action.

## Facts

- Endpoint: POST https://aemb.pro/v1/agent-id/revoke?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-embassy-revoke-agent-id-8bdd068b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XajlhzajStN5hI-Gn6wnD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-embassy-revoke-agent-id-8bdd068b -d '<json body>'
```

Example prompt: Revoke the agent ID 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef on Agent Embassy for account 0x1111111111111111111111111111111111111111 — I need the embassy receipt as proof it was invalidated.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Agents pay for work and prove what happened.

## Output

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').

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-embassy-revoke-agent-id-8bdd068b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aemb.pro](https://www.zero.xyz/host/aemb.pro/llms.txt)