# AgentLine Phone Number Lease Renewal (PATCH)

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

Renews or updates an active phone number lease for an AI agent using a lease token, enabling continued outbound calling, SMS, and inbound voice capabilities.

## Facts

- Endpoint: GET https://api.agentline.cloud/v1/x402/agents
- Price: $0.01/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-lease-renewal-patch-d17198ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uh8ZlDfyYi0lt9858kwFa

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-lease-renewal-patch-d17198ba
```

Example prompt: Renew the phone number lease for my AI agent using lease token 'lse_abc123xyz' so it doesn't lose its number and can keep making and receiving calls.

## When to prefer this

Use this endpoint when you already have an active (or recently active) phone number lease for an AI agent and need to renew or update it, rather than provisioning a new number from scratch. It is the correct choice when you have a valid lease_token and want to maintain continuity of the same phone number for your agent's voice and SMS capabilities.

## Known failure modes

- Invalid or expired lease_token returns an error preventing renewal
- Payment of $0.01 USDC fails or is not authorized, blocking the patch
- Lease token belongs to a different agent or account, resulting in authorization error
- Phone number has already been permanently released and cannot be renewed
- Network timeout or server error during the PATCH operation

## 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

Returns confirmation that the lease has been updated or renewed, maintaining the agent's assigned real phone number for continued voice and SMS operations. The response body schema is not detailed, but typically includes updated lease metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "voice_id": {
   "type": "string"
  },
  "agent_name": {
   "type": "string"
  },
  "owner_phone": {
   "type": "string"
  },
  "system_prompt": {
   "type": "string"
  },
  "transfer_number": {
   "type": "string"
  },
  "initial_greeting": {
   "type": "string"
  },
  "voicemail_message": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "agent": {
   "type": "object"
  },
  "owner_wallet": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentline-phone-number-lease-renewal-patch-d17198ba/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)