Update survey question

PUT/manage/events/:eventId/questions/:questionId

Update a survey question. Requires the questionsWrite permission.

AuthLogin required

Path parameters

eventIdstringrequired

Event ID or slug.

questionIdstringrequired

Question ID.

Request body

typestring

Question type (required on create); one of text / longText / email / url / singleSelect / multiSelect / toggle / radioButton / date / image.

titlestring

Question text; up to 255 characters.

descriptionstring

Description; up to 500 characters.

languagesobject

Localized question text / help.

optionsobject[]

Options for singleSelect / multiSelect / radioButton questions; each option carries a label.

requiredboolean

Whether an answer is required.

ticketIdsstring[]

Ticket IDs this question applies to; an empty array means all tickets.

ordernumber

Display order; an integer. Defaults to 9999.

statusstring

One of DRAFT / PUBLISHED / PRIVATE.

searchableboolean

Whether the answer is searchable.

showOnDashboardboolean

Whether to aggregate on the dashboard.

branchParentId / conditionOptionIds / positionstring | string[] | number

Conditional branching settings.

settingsobject

Type-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>object

Language code (ja, en, …)

<lang>.titlestring

Title shown in that language.

<lang>.descriptionstring

Description 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.

idstring

Option ID; specify it to update an existing option and omit it to add a new one.

labelstringrequired

Option label.

languagesobject

Localized 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.

widthnumber

Image width in pixels; an integer from 16 to 4096.

heightnumber

Image height in pixels; an integer from 16 to 4096.

{
  "width": 1200,
  "height": 630
}
Request
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
}'
Example response
{
"id": "q1a2b3c4-...",
"refId": "purpose",
"type": "text",
"title": "参加目的を教えてください",
"description": null,
"required": true,
"options": [],
"ticketIds": [],
"order": 0,
"status": "PUBLISHED",
"searchable": false,
"showOnDashboard": false
}