Create survey question

POST/manage/events/:eventId/questions

Create a registration survey question. Requires the questionsWrite permission.

Auth	Login required

Path parameters

eventIdstringrequired

Event ID or slug.

Request body

refIdstring

Reference ID for the question (identifier from a template)

typestringrequired

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

titlestringrequired

Question text (required); 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 \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "type": "text",
  "title": "参加目的を教えてください",
  "required": true,
  "status": "PUBLISHED"
}'

Example response
{
  "id": "q1a2b3c4-...",
  "refId": "purpose",
  "type": "text",
  "title": "参加目的を教えてください",
  "description": null,
  "required": true,
  "options": [],
  "ticketIds": [],
  "order": 0,
  "status": "PUBLISHED",
  "searchable": false,
  "showOnDashboard": false
}