Update a survey

Updates a survey in place; fields you omit keep their current values, and at least one field must be present. question_order renumbers the questions wholesale and must name exactly the survey's existing questions — the renumbering is applied one question at a time and is not transactional, so a failure midway can leave the order partly applied. Renaming the survey also renames and republishes its call routing; changing any other field leaves the routing alone. Keys the survey does not recognize are accepted and ignored.

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

The survey's UUID; the format is not checked.

Body Params
string

New name for the survey; must be nonblank. Also renames its call routing.

string

New description; must be nonblank when supplied.

boolean

Whether the survey is active.

string

Language every question falls back to, as en or en-US.

string

Voice used when generating question audio.

invalid_actions
array of objects

What to do when a caller presses something the question does not accept; replaces the current list.

invalid_actions
timeout_actions
array of objects

What to do when a caller says nothing in time; replaces the current list.

timeout_actions
question_order
array of strings

The survey's question UUIDs in the order you want them asked. Must contain exactly the questions the survey already has.

question_order
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