{"uid":"cap_u7XZJX8rPjQcnthcYIqso","slug":"agent-embassy-agent-identity-renew-2b5dcf59","name":"Agent Embassy — Agent Identity Renew","description":"Agents pay for work and prove what happened.","url":"https://aemb.pro/v1/agent-id/renew?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"agent_id":{"type":"string","description":"The Agent ID string returned at issuance (64 hex characters; case-insensitive). Unknown IDs are rejected"},"validity_days":{"type":"number","description":"Days until the renewed Agent ID expires; integer 1-730. Defaults to the Embassy standard when omitted"},"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:<OLD_agent_id> (64-char lowercase ID, no trailing newline) — the signature covers the OLD Agent ID being retired. 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_renew","chain":["request","authorization","action","proof","liability_boundary"],"status":"complete","account":"0x1111111111111111111111111111111111111111","agent_id":"fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210","receipt_id":"emb_3c4d5e6f7890abcdef123456","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_V3tQLA2zuYC5MlaxlqglY","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":"Renews an agent's on-chain identity, records the authorization chain, and issues a tamper-evident embassy receipt proving what happened.","exampleAgentPrompt":"Renew my Agent Embassy identity — my agent ID is fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210 and account is 0x1111111111111111111111111111111111111111 — and give me back the receipt proving the renewal happened.","exampleUseCases":[{"title":"Keeping agent credentials active","prompt":"My autonomous agent's Embassy ID is about to expire — renew it using account 0xAbCd1234...5678 and agent ID abc123...def456, and store the receipt so I can prove it's still authorized to act on my behalf."},{"title":"Proving authorized agent action after task completion","prompt":"My agent just finished a job — renew its Agent Embassy identity for account 0xDEAD...BEEF with agent ID 1234...abcd and get me the embassy receipt that proves the full authorization chain so I can show exactly what was sanctioned."},{"title":"Establishing liability boundary before high-stakes operation","prompt":"Before my agent executes the next workflow step, renew its identity on Agent Embassy for account 0x9999...0000 and agent ID fedcba...543210 so we have a clean proof-of-authorization and a liability boundary on record."}],"resultDescription":"Returns a JSON object containing the tool name (agentid_renew), the full authorization chain array (request, authorization, action, proof, liability_boundary), completion status, the account address, the agent ID, a unique receipt ID (emb_...), and the receipt version (embassy-receipt/1). This receipt serves as tamper-evident proof that the renewal was authorized and executed.","failureModes":["Insufficient USDC payment — 402 Payment Required if payment header is missing or underfunded","Invalid or expired agent ID — renewal rejected if the agent ID does not exist or is unrecognizable","Invalid account address — malformed Ethereum address causes request failure","Duplicate renewal attempt within the same validity window — may return conflict or idempotency error","Network or chain congestion — slow on-chain confirmation may cause timeout"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to maintain an active, verifiable on-chain identity and produce cryptographic proof that its actions were authorized. It is specifically suited for agentic workflows where accountability, liability boundaries, and tamper-evident receipts are required — particularly when integrating with the Agent Embassy ecosystem. Prefer this over generic auth tokens or session renewal when you need an auditable chain of custody tying an agent action to a specific account.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:30:28.242Z","isFirstParty":false,"canonicalSlug":"agent-embassy-agent-identity-renew-2b5dcf59"}