Update survey question
/manage/events/:eventId/questions/:questionIdUpdate a survey question. Requires the questionsWrite permission.
| Auth | Login required |
|---|
Path parameters
eventIdstringrequiredEvent ID or slug.
questionIdstringrequiredQuestion ID.
Request body
typestringQuestion type (required on create); one of text / longText / email / url / singleSelect / multiSelect / toggle / radioButton / date / image.
titlestringQuestion text; up to 255 characters.
descriptionstringDescription; up to 500 characters.
languagesobjectLocalized question text / help.
optionsobject[]Options for singleSelect / multiSelect / radioButton questions; each option carries a label.
requiredbooleanWhether an answer is required.
ticketIdsstring[]Ticket IDs this question applies to; an empty array means all tickets.
ordernumberDisplay order; an integer. Defaults to 9999.
statusstringOne of DRAFT / PUBLISHED / PRIVATE.
searchablebooleanWhether the answer is searchable.
showOnDashboardbooleanWhether to aggregate on the dashboard.
branchParentId / conditionOptionIds / positionstring | string[] | numberConditional branching settings.
settingsobjectType-specific settings.
Object structures
languages
Keyed by language code; each entry overrides the title / description shown for that language. Languages you omit fall back to the default fields.
<lang>objectLanguage code (ja, en, …)
<lang>.titlestringTitle shown in that language.
<lang>.descriptionstringDescription shown in that language.
{
"ja": { "title": "オープニング基調講演", "description": "..." },
"en": { "title": "Opening Keynote", "description": "..." }
}options
Options for singleSelect / multiSelect / radioButton questions. Answers reference each option by its id.
idstringOption ID; specify it to update an existing option and omit it to add a new one.
labelstringrequiredOption label.
languagesobjectLocalized labels ({ [lang]: { label } })
[
{ "id": "o1", "label": "SNS", "languages": { "en": { "label": "Social media" } } },
{ "label": "知人の紹介" }
]settings
Type-specific settings. Currently only used to constrain the image size for image questions.
widthnumberImage width in pixels; an integer from 16 to 4096.
heightnumberImage height in pixels; an integer from 16 to 4096.
{
"width": 1200,
"height": 630
}curl https://api.4s.link/manage/events/EVENT_ID/questions/QUESTION_ID \-X PUT \-H "Authorization: Bearer 4s_at_..." \-H "Content-Type: application/json" \-d '{"title": "参加のきっかけを教えてください","required": false}'
{"id": "q1a2b3c4-...","refId": "purpose","type": "text","title": "参加目的を教えてください","description": null,"required": true,"options": [],"ticketIds": [],"order": 0,"status": "PUBLISHED","searchable": false,"showOnDashboard": false}