Add a survey question

Adds a question to a survey, generates its spoken audio and republishes the survey's call routing. question_number defaults to one past the highest number in use, and a number already taken is rejected. When actions is supplied it must include the survey's default language, and each language entry must carry exactly one of question_text or custom_actions. Entries are written for the default language and every language already used elsewhere in the survey, filling gaps with the default language's text or a Question N placeholder — a language that appears only in this request is not added to that set.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The survey's UUID.

Body Params
number

Where the question falls in the survey. Defaults to one past the highest number in use, or 1; a number already taken is rejected with 400.

string
enum

How the answer is collected: rating, boolean, digit or custom. Defaults to rating and is not checked against that list.

Allowed:
number | null

Lowest accepted answer, for numeric question types. Defaults to none.

number | null

Highest accepted answer, for numeric question types. Defaults to none.

valid_responses
array of strings | null

The exact answers the question accepts. Defaults to none.

valid_responses
boolean

Whether the caller must answer before moving on. Defaults to true.

actions
object

What the caller hears, keyed by language code. Must include the survey's default language, and each entry needs exactly one of question_text or custom_actions, with an optional voice.

Responses

401

Missing or invalid API key.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json