Batch Calls

Change Batch Call Phone Number

Changes the From number for a draft, scheduled, or paused batch to another outbound number linked to its agent. Pause running or waiting batches first and wait for in-progress calls to finish. Undialed calls and parked retries use the new number; placed calls keep their original number. The agent version and batch status stay the same.

patch/v1/batch-calls/{id}/phone-number

Request

  • Base URL: https://api.dialnexa.com
  • URL: https://api.dialnexa.com/v1/batch-calls/{id}/phone-number
  • Auth: HTTP bearer

Path parameters

idstring required
Example:batch_abc123

Batch ID from List Batch Calls.

Request body

phone_number_idstring required

One of the batch agent's outbound phone number IDs.

Example request

{
  "phone_number_id": "phn_abc123"
}

Response

The number was changed. API-key callers receive an empty object because the response projection omits the control result.

object required

Changes

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