{"uid":"cap_Pc9UazpCTXOxJNVbXodA9","slug":"agent-embassy-agent-identity-issuance-eefeef5c","name":"Agent Embassy — Agent Identity Issuance","description":"Agents pay for work and prove what happened.","url":"https://aemb.pro/v1/agent-id/issue?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"agent_pubkey":{"type":"string","description":"The agent's public key (hex), the root of the Agent ID"},"principal_id":{"type":"string","description":"ID of the accountable principal on file with the Embassy"},"operator_name":{"type":"string","description":"Public name of the operator running the agent"},"validity_days":{"type":"number","description":"Days until the Agent ID expires; integer 1-730. Defaults to the Embassy standard when omitted"},"principal_kind":{"type":"string","description":"Kind of principal: human or legal_entity"},"idempotency_key":{"type":"string","description":"Idempotency key: UUID v4, client-generated, one per logical request. Replaying the same key on this tool returns the original receipt — the action is not re-run, and the first request's receipt wins even if you resend different inputs. Published example keys are rejected. Keys are scoped per tool and per payer account: a key never returns another wallet's receipt."},"principal_label":{"type":"string","description":"Public label for the principal"},"agent_key_scheme":{"type":"string","description":"Key scheme for agent_pubkey: eip191 or ed25519 (default eip191)"},"operator_contact":{"type":"string","description":"Public contact for the operator"},"principal_attestation_method":{"type":"string","description":"How the Embassy verified the principal"}}},"responseSchema":{"type":"json","example":{"tool":"agentid_issue","chain":["request","authorization","action","proof","liability_boundary"],"status":"complete","account":"0x1111111111111111111111111111111111111111","agent_id":"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","receipt_id":"emb_9f8e7d6c5b4a3210fedcba98","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_ZwtFdlXpv1aWba982FArt","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":"Issues a cryptographically verifiable agent identity and receipt after an agent pays for and completes a unit of work, establishing an auditable proof of action with liability boundaries.","exampleAgentPrompt":"Issue an Agent Embassy identity and receipt for my agent at account 0x1111...1111 — I need a verifiable proof chain showing the request, authorization, action, and liability boundary after it completes and pays for this task.","exampleUseCases":[{"title":"Autonomous agent task accountability","prompt":"My agent just finished a paid job — can you get it an Agent Embassy receipt that proves what it did, what it paid, and where the liability boundary sits? The agent account is 0xAbCd...1234."},{"title":"Multi-agent fleet identity management","prompt":"I'm running a fleet of AI agents and I need each one to have a verifiable agent ID issued by Agent Embassy after they pay for and complete their assigned work — start with the agent at address 0xDEAD...BEEF."},{"title":"Compliance audit trail for agent action","prompt":"For compliance purposes, I need a cryptographic proof from Agent Embassy showing exactly what my agent authorized, what action it took, and what payment it made — please issue the receipt for account 0x9999...AAAA so I have a full chain of evidence."}],"resultDescription":"Returns a JSON object containing the tool name (agentid_issue), a proof chain array listing stages (request, authorization, action, proof, liability_boundary), a status field, the agent's account address, a 64-character hex agent_id, a unique receipt_id prefixed with 'emb_', and a receipt_version string (embassy-receipt/1). This receipt serves as an immutable, verifiable record of the agent's identity, payment, and action.","failureModes":["Payment not received or insufficient — 402 response before receipt is issued","Invalid or malformed account address — request rejected","Duplicate receipt attempt for the same action — may return conflict or deduplicated result","Network or chain timeout during proof generation — incomplete receipt","Authorization step fails — chain halted before action proof is created"],"whenToPreferThis":"Choose this endpoint when you need a cryptographically anchored, machine-readable proof that an autonomous agent paid for and completed a specific action — especially in multi-agent systems requiring accountability, liability boundaries, or compliance audit trails. It is distinct from simple payment APIs because it issues a persistent agent identity and a structured proof chain, not just a payment confirmation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:49:04.981Z","isFirstParty":false,"canonicalSlug":"agent-embassy-agent-identity-issuance-eefeef5c"}