Outplan

Update dial information of an existing outplan.

Changed on

Updates the dial information for the outplan specified by the given ID and returns the updated outplan.

put/outplans/{id}/dial_info

Request

  • Base URL
    https://api.voipbin.net/v1.0
  • URL
    https://api.voipbin.net/v1.0/outplans/{id}/dial_info
  • Auth
    none declared

Path parameters

idstring required

The ID of the outplan to update.

Request body

dial_timeoutinteger

The new dial timeout in seconds. Omit to leave unchanged.

try_intervalinteger

The new interval between retry attempts. Omit to leave unchanged.

max_try_count_0integer

The new maximum retry count for destination 0. Omit to leave unchanged.

max_try_count_1integer

The new maximum retry count for destination 1. Omit to leave unchanged.

max_try_count_2integer

The new maximum retry count for destination 2. Omit to leave unchanged.

max_try_count_3integer

The new maximum retry count for destination 3. Omit to leave unchanged.

max_try_count_4integer

The new maximum retry count for destination 4. Omit to leave unchanged.

Example request

{
  "source": {
    "type": "tel",
    "target": "+14155551234",
    "target_name": "John Smith",
    "name": "Main Office",
    "detail": "Primary contact number"
  }
}

Response

The updated outplan with new dial information.

idstring uuid

The unique identifier of the outplan.

customer_idstring uuid

The unique identifier of the customer. Returned from the GET /customers response.

namestring

Name of the outplan.

detailstring

Detailed information about the outplan.

dial_timeoutinteger

Dial timeout in milliseconds.

try_intervalinteger

Interval between dialing attempts in milliseconds.

max_try_count_0integer

Maximum number of tries for level 0.

max_try_count_1integer

Maximum number of tries for level 1.

max_try_count_2integer

Maximum number of tries for level 2.

max_try_count_3integer

Maximum number of tries for level 3.

max_try_count_4integer

Maximum number of tries for level 4.

tm_createstring date-time

Timestamp when the outplan was created.

tm_updatestring date-time

Timestamp when the outplan was last updated.

tm_deletestring date-time

Timestamp when the outplan was deleted.

Example response

{
  "id": "2b3c4d5e-6f7a-8901-bcde-f12345678901",
  "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "name": "Standard Outbound Plan",
  "detail": "Default outbound dialing plan for campaigns",
  "source": {
    "type": "tel",
    "target": "+14155551234",
    "target_name": "John Smith",
    "name": "Main Office",
    "detail": "Primary contact number"
  },
  "dial_timeout": 30000,
  "try_interval": 60000,
  "max_try_count_0": 3,
  "max_try_count_1": 2,
  "max_try_count_2": 1,
  "max_try_count_3": 1,
  "max_try_count_4": 1,
  "tm_create": "2026-01-15T09:30:00.000000Z",
  "tm_update": "2026-01-15T09:30:00.000000Z",
  "tm_delete": "2026-01-15T09:30:00.000000Z"
}

Changes

  • d15cd059ccdbRevision changes
    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional

  • d5569b315411Revision changes
    • warning

      added the new web_session enum value to the / response property for the response status

    • info

      added the new web_session enum value to the request property /