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' (the line's carrier connection was lost). 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' (the line's carrier connection was lost). 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"
    }
  ]
}