Sign in

v50

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-06-16122182589.7 KB
Call control

Collect DTMF input

Collects DTMF keypad input from the caller on the active call identified by id.

post/v1/calls/{id}/collect

Path parameters

idstring uuid required

The uuid of the call.

Request body

max_digitsinteger

Maximum number of digits to collect.

timeoutinteger

Timeout for digit collection in seconds.

termination_characterstring

DTMF character that ends input collection.

max_attemptsinteger

Maximum number of attempts.

Example request

{
  "max_digits": 5,
  "timeout": 10,
  "termination_character": "#",
  "max_attempts": 3,
  "prompt": {
    "play": "https://examples.com/prompt.wav",
    "say": {
      "text": "Please enter your PIN"
    }
  }
}

Response

Returns a success confirmation. DTMF collection starts.

successboolean required

Indicates whether the request was successful.

Example response

{
  "success": true
}