{"uid":"cap_uEeWtxcBoKPebU3Ngg6vi","slug":"agent-embassy-renew-agent-id-8942d1ad","name":"Agent Embassy — Renew Agent ID","description":"Agents pay for work and prove what happened.","url":"https://agent-embassy.fly.dev/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/1"}},"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_rDpSSi9ghNvh4RWoUGwmM","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 existing Agent ID credential, extending its validity period and returning a signed receipt proving the renewal occurred.","exampleAgentPrompt":"Renew my Agent Embassy agent ID fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210 for 365 days and give me the signed receipt proving the renewal happened.","exampleUseCases":[{"title":"Prevent agent credential expiry","prompt":"My agent's Embassy ID fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210 is about to expire — renew it for 180 days so it stays active."},{"title":"Rotate and retire old agent identity","prompt":"I want to retire my old agent ID fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210 and renew it fresh for 30 days — here's the revocation signature: 0xabc123..."},{"title":"Safe idempotent renewal with deduplication","prompt":"Renew agent ID fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210 for 90 days using idempotency key 550e8400-e29b-41d4-a716-446655440000 so I don't get charged twice if the request retries."}],"resultDescription":"A JSON object containing the tool name, a chain array describing the lifecycle steps (request, authorization, action, proof, liability_boundary), a status of 'complete', the paying account address, the renewed agent_id, a unique receipt_id (emb_...), and a receipt_version string — together forming a signed, auditable proof of renewal.","failureModes":["Unknown or malformed agent_id (not 64 hex chars) → rejected with error","Invalid revocation_signature (wrong key, wrong message format, or raw ECDSA without EIP-191 envelope) → verification failure","validity_days outside 1-730 range → validation error","Replayed published idempotency_key → rejected","Insufficient USDC balance or payment failure → x402 payment error","Expired or already-revoked agent_id → rejected"],"whenToPreferThis":"Use this endpoint when you need to extend the lifetime of an existing Agent Embassy agent ID credential rather than issuing a new one. Prefer this over issuance when the agent already has an on-file identity that downstream systems recognize. Choose it when you need a tamper-evident, on-chain-provable receipt of the renewal action, not just a silent database update.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:33:49.173Z","isFirstParty":false,"canonicalSlug":"agent-embassy-renew-agent-id-8942d1ad"}