Update a survey question

patch

https://api.emaktalk.com/api/v1/surveys/{id}/questions/{question_id}

Updates a question in place; at least one field must be present and omitted fields keep their current values. actions upserts only the languages you send, leaving the rest alone, and each entry needs exactly one of question_text or custom_actions. Changing the text regenerates that language's audio using the voice you send, the survey's default voice, or alloy. The structural fields and the language entries are written concurrently and are not transactional, and the call routing is not republished here.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

The survey's UUID.

question_id

string

required

UUID of a question that belongs to that survey.

Body Params

question_number

number

New position for the question; a number another question already holds is rejected with 400.

question_type

string

enum

How the answer is collected: rating, boolean, digit or custom. Not checked against that list.

Allowed:

min_value

number | null

Replacement lowest accepted answer.

max_value

number | null

Replacement highest accepted answer.

valid_responses

array of strings | null

Replacement list of the exact answers the question accepts.

valid_responses

required

boolean

Whether the caller must answer before moving on.

actions

object

Language entries to add or replace, keyed by language code. Each needs exactly one of question_text or custom_actions, with an optional voice; languages you leave out are untouched.

Responses

401

Missing or invalid API key.

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The question was updated.

400The body was empty or invalid, question_number is already taken, a language entry was malformed, or the write failed.

403Your API key lacks the Admin role, or the survey is not on your account.

404No such survey, or the question is not one of its questions.

500The update failed partway through.