{"uid":"cap_gVw02itilOw_hiT-3JaQ4","slug":"kya-brasil-renew-agent-credential-bbe3b7f9","name":"KYA Brasil – Renew Agent Credential","description":"Re-issue the credential for 90 more days. The company signs the renewal challenge with an e-CNPJ in force (not revoked); the company must still be ATIVA at the Receita.","url":"https://kya-br-agents.marcelfons.workers.dev/v1/agents/:id/renew?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":[],"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"pathParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"credential_id returned by POST /v1/agents"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KTmYkjfsXGt6NMOZVmMaV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Re-issues a Brazilian AI agent credential for 90 more days, requiring the company's e-CNPJ to be valid and the company to be ATIVA at Receita Federal.","exampleAgentPrompt":"My KYA Brasil agent credential is about to expire — please renew it for another 90 days using the credential ID cred_abc123, our e-CNPJ is still active and the company is ATIVA at Receita Federal.","exampleUseCases":[{"title":"Pre-expiry automated credential renewal","prompt":"Our AI agent's KYA Brasil credential expires in 3 days — renew it now for another 90 days so it doesn't lose authorization to act on behalf of our CNPJ."},{"title":"Post-suspension credential reactivation","prompt":"We just confirmed that our company is back to ATIVA status at Receita Federal and our e-CNPJ is valid again — can you renew the KYA Brasil credential with ID cred_xyz789 for 90 more days?"},{"title":"Scheduled quarterly agent re-authorization","prompt":"It's time for our quarterly refresh — renew the KYA Brasil agent credential for credential ID cred_q1_2025 so our automated compliance agent keeps its mandate for the next 90 days."}],"resultDescription":"Returns a renewed credential object with an updated validity window of 90 days from the renewal date, along with the credential status confirming re-issuance. The company must be ATIVA at Receita Federal and must sign the renewal challenge with a non-revoked e-CNPJ.","failureModes":["Company is not ATIVA at Receita Federal — renewal rejected","e-CNPJ is revoked or expired — signing challenge fails","Invalid or unknown credential_id — 404 not found","Credential already expired beyond renewal window — cannot renew","Payment of 0.1 USDC not completed via x402 protocol — 402 Payment Required","Malformed POST body or missing required fields — 400 Bad Request"],"whenToPreferThis":"Use this endpoint when an existing KYA Brasil agent credential is approaching or has recently reached its 90-day expiry and the underlying Brazilian company remains ATIVA at Receita Federal with a valid e-CNPJ. This is the correct renewal path (not re-registration) for maintaining continuity of an agent's authorization without creating a new credential from scratch.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T06:34:39.045Z","isFirstParty":false,"canonicalSlug":"kya-brasil-renew-agent-credential-bbe3b7f9"}