agents

Update a transfer number

Partial update — label, description, phone, work hours, or active flag. Label uniqueness is re-checked if changed. Phone is re-validated (E.164 + supported countries). Use when restructuring teams, updating numbers, or adjusting seasonal hours.

patch/agents/{id}/transfer-numbers/{transferId}

Request

  • Base URL: https://be.skipcalls.com (the document declares no server; this is the origin it was published from)
  • URL: https://be.skipcalls.com/agents/{id}/transfer-numbers/{transferId}
  • Auth: HTTP bearer

Path parameters

idstring required
transferIdstring required

Request body

labelstring

Single lowercase word label (e.g., sales, support)

descriptionstring

Description explaining when AI should transfer to this number

phoneNumberstring

Phone number (will be normalized to E.164)

workHoursobject

Work hours schedule by day (e.g., {MONDAY: [900, 1730]}). Null means 24/7

transferType'warm' | 'cold'

Transfer type: "warm" (AI briefs recipient before connecting) or "cold" (direct transfer)

isActiveboolean

Whether this transfer number is active

Example request

{
  "label": "sales",
  "description": "Use for sales inquiries and new customer questions",
  "phoneNumber": "+1234567890",
  "workHours": {
    "MONDAY": [
      900,
      1730
    ],
    "TUESDAY": [
      900,
      1730
    ]
  }
}

Response

Transfer number updated successfully

idstring required
labelstring required
descriptionstring required
phoneNumberstring required
workHoursobject nullable
transferType'warm' | 'cold' required
isActiveboolean required
sortOrdernumber required
createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.