PayphonePayphone
Api reference

Replace Orphaned Line (Free)

Replace an orphaned phone line with a new one at no charge. Only works on lines with status 'orphaned' (XMPP server went offline). The old line stays accessible for history viewing.

Replace an orphaned phone line with a new one at no charge. Only works on lines with status 'orphaned' (XMPP server went offline). The old line stays accessible for history viewing.

POST
/api/v1/numbers/replace/:lineId

Authorization

bearer
AuthorizationBearer <token>

Privy access token (dashboard sessions, ~1h TTL) or long-lived dial_live_* / dial_test_* API key minted from /dashboard/billing. API keys are scope-gated per route (sms:send, numbers:read, account:read, etc.); Privy sessions bypass scope checks. See /docs/api-reference/api-keys for the full scope catalogue.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

lineId?string

ID of the orphaned line to replace (from URL path)

Response Body

application/json

application/json

curl -X POST "https://payphone.wtf/api/v1/numbers/replace/:lineId" \  -H "Content-Type: application/json" \  -d '{}'
{
  "success": true,
  "newLineId": "string",
  "newJobId": "string",
  "message": "string"
}
{
  "x402Version": 2,
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "100000",
      "payTo": "string"
    }
  ]
}