# AgentLine Phone Number Renewal

> AgentLine Phone Number Renewal is a paid API for AI agents from api.agentline.cloud, paid per call via x402, $2/call, status unknown (last checked 2026-09-16).

Renews the lease on a wallet-owned phone number for an AI agent, keeping it active for continued voice and SMS use.

## Facts

- Endpoint: POST https://api.agentline.cloud/v1/x402/numbers/renew
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentline-phone-number-renewal-015728f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qE2c-GV7nCZHsWgDAUuDB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentline-phone-number-renewal-015728f2 -d '<json body>'
```

Example prompt: My AI agent's phone number +14155550192 is about to expire — go ahead and renew it so it stays active for calls and SMS.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "phone_number"
 ],
 "properties": {
  "phone_number": {
   "type": "string",
   "description": "Your wallet-owned number to renew (E.164)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tx_hash": {
   "type": "string"
  },
  "owner_wallet": {
   "type": "string"
  },
  "phone_number": {
   "type": "string"
  },
  "lease_expires_at": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentline-phone-number-renewal-015728f2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentline.cloud](https://www.zero.xyz/host/api.agentline.cloud/llms.txt)