{"uid":"cap_qE2c-GV7nCZHsWgDAUuDB","slug":"agentline-phone-number-renewal-015728f2","name":"AgentLine Phone Number Renewal","description":"Get a real phone number for your AI agent in under 10 minutes. Works with OpenClaw, Hermes Agent, and any LLM. Outbound calls, SMS, and inbound voice — one API. No telecom experience needed.","url":"https://api.agentline.cloud/v1/x402/numbers/renew","method":"POST","headers":{},"bodySchema":{"type":"object","required":["phone_number"],"properties":{"phone_number":{"type":"string","description":"Your wallet-owned number to renew (E.164)"}}},"responseSchema":{"type":"object","properties":{"tx_hash":{"type":"string"},"owner_wallet":{"type":"string"},"phone_number":{"type":"string"},"lease_expires_at":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"2","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":"$2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MLMe8wRYc_FvoyZ7bW5fS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Renews the lease on a wallet-owned phone number for an AI agent, keeping it active for continued voice and SMS use.","exampleAgentPrompt":"My AI agent's phone number +14155550192 is about to expire — go ahead and renew it so it stays active for calls and SMS.","exampleUseCases":[{"title":"Automated agent number renewal","prompt":"My customer-service bot's phone number +12125550188 is expiring soon — renew it so it doesn't go offline and stop taking inbound calls."},{"title":"Keeping outbound sales agent live","prompt":"My outbound sales agent uses +18005550143 for cold calls — make sure that number stays active by renewing it right now."},{"title":"Scheduled renewal for multi-agent fleet","prompt":"I have an agent fleet and the number +14085550177 is up for renewal — extend it so my agents can keep using it for both voice and SMS without interruption."}],"resultDescription":"A confirmation that the specified phone number's lease has been renewed and extended, along with any updated expiry information returned by the API. The exact response schema is not detailed, but a successful call signals the number remains active and wallet-owned.","failureModes":["Phone number not found or not owned by the calling wallet — returns an error indicating invalid ownership","Malformed E.164 phone number format — returns a validation error","Payment failure (insufficient USDC balance for $2 fee) — returns a 402 Payment Required error","Number already expired or recycled — may return an error indicating it can no longer be renewed","Rate limiting or service unavailability — returns a 429 or 5xx error"],"whenToPreferThis":"Use this endpoint specifically when an AI agent already holds a wallet-owned phone number provisioned through AgentLine and needs to extend its active lease before it expires. This is not for provisioning a new number or porting an existing one — it is purely a renewal/extension operation. Prefer this over re-provisioning if the agent needs to retain the same phone number for continuity of inbound routing, caller ID, or SMS threads.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:36:31.657Z","isFirstParty":false}