Skip to main content

Update Question

Change one of the questions an experience asks each person. Send only what changes; everything else stays as it is.

A question asked on more than one experience changes on all of them. A size question cannot be changed here, because its choices come from the item: change the sizes on the item, or stop asking it with ask_size: false on the experience's gear row.

Endpointโ€‹

PATCH /v1/experiences/{id}/questions/{fieldId}

Authenticationโ€‹

Requires an API key with the experiences:write scope.

Path Parametersโ€‹

ParameterTypeDescription
idintegerThe experience ID
fieldIdintegerThe question's field_id, from List Questions

Request Bodyโ€‹

All fields are optional. They are the same fields Add Question takes: label, answer_type, choices, required and checked_at_checkin.

{
"checked_at_checkin": true
}

Responseโ€‹

Success (200 OK)โ€‹

The same shape as Add Question: question is the changed one, followed by the experience's full list.

Errorsโ€‹

StatusCodeDescription
401authentication_requiredNo API key provided
401invalid_api_keyInvalid API key
403insufficient_scopeAPI key lacks experiences:write scope
403forbiddenThe experience belongs to another account
404resource_not_foundThe experience does not exist, or does not ask this question
422validation_errorA field is wrong, or the question is a size ("A size question takes its choices from the item. Change the sizes on the item.")

Example Requestโ€‹

curl -X PATCH "https://app.equipdash.com/api/v1/experiences/12/questions/88" \
-H "Authorization: Bearer eqd_live_abc123xyz789..." \
-H "Content-Type: application/json" \
-d '{"checked_at_checkin": true}'