> For the complete documentation index, see [llms.txt](https://movemint.gitbook.io/movemint-developer-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://movemint.gitbook.io/movemint-developer-docs/open-api-specification/core-resources/questions.md).

# Questions

Manage event-level custom registration questions, including multiple- choice options. The API attaches each question to the event broadly; per-sub-event/waitlister scoping is handled via the admin UI.

## GET /api/v1/events/{handle}/questions

> List custom registration questions

````json
{"openapi":"3.1.0","info":{"title":"Movemint API","version":"1.0"},"tags":[{"name":"Questions","description":"Manage event-level custom registration questions, including multiple-\nchoice options. The API attaches each question to the event broadly;\nper-sub-event/waitlister scoping is handled via the admin UI.\n"}],"servers":[{"url":"https://www.movemint.cc","description":"Production"}],"security":[{"bearerAuth":[]},{"oauth2":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Pass the access token in the `Authorization` header:\n```\nAuthorization: Bearer YOUR_ACCESS_TOKEN\n```\n"},"oauth2":{"type":"oauth2","description":"OAuth 2.0 authentication using the Authorization Code or Client\nCredentials grant flow.\n","flows":{"authorizationCode":{"authorizationUrl":"https://www.movemint.cc/oauth/authorize","tokenUrl":"https://www.movemint.cc/oauth/token","refreshUrl":"https://www.movemint.cc/oauth/token","scopes":{}},"clientCredentials":{"tokenUrl":"https://www.movemint.cc/oauth/token","scopes":{}}}}},"parameters":{"EventHandle":{"name":"handle","in":"path","required":true,"description":"The unique handle (slug) of the event","schema":{"type":"string"}}},"schemas":{"CustomQuestion":{"type":"object","required":["id","question_id","title","question_type","required","order","starts_at","ends_at","options","children"],"properties":{"id":{"type":"integer","format":"int64","description":"TransactableCustomQuestion id (the link row, used for update/delete)."},"question_id":{"type":"integer","format":"int64"},"title":{"type":"string"},"question_type":{"type":"string","enum":["text","multiple_choice","time_hr_min_second","time_min_second"]},"required":{"type":"boolean"},"order":{"type":"integer"},"starts_at":{"type":"string","format":"date-time","nullable":true},"ends_at":{"type":"string","format":"date-time","nullable":true},"options":{"type":"array","description":"Answer options in the order they are shown to registrants.","items":{"$ref":"#/components/schemas/CustomQuestionOption"}},"children":{"type":"array","description":"Conditional child questions revealed by this question's answers. Only multiple-choice questions can have children; empty otherwise.","items":{"$ref":"#/components/schemas/NestedQuestionChild"}}}},"CustomQuestionOption":{"type":"object","required":["id","label"],"properties":{"id":{"type":"integer","format":"int64"},"label":{"type":"string"}}},"NestedQuestionChild":{"type":"object","description":"A conditional (nested) child question shown only when this question is answered with one of the trigger options. References a question that also appears in full elsewhere in the questions list.","required":["link_id","child_question_id","show_when"],"properties":{"link_id":{"type":"integer","format":"int64","description":"NestedQuestionLink id (used to delete the link)."},"child_question_id":{"type":"integer","format":"int64","description":"Question id (the `id` field) of the child question to show."},"show_when":{"type":"array","description":"Parent option labels that reveal the child question.","items":{"type":"string"}}}},"OAuthError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Machine-readable error code"},"error_description":{"type":"string","description":"Human-readable description of the error"}}},"Error":{"type":"object","description":"A generic error response","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}}},"Forbidden":{"description":"Forbidden - user is not an admin of this event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"EventNotFound":{"description":"Event not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/events/{handle}/questions":{"get":{"tags":["Questions"],"summary":"List custom registration questions","operationId":"listEventQuestions","parameters":[{"$ref":"#/components/parameters/EventHandle"}],"responses":{"200":{"description":"Ordered list of questions","content":{"application/json":{"schema":{"type":"object","required":["questions"],"properties":{"questions":{"type":"array","items":{"$ref":"#/components/schemas/CustomQuestion"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/EventNotFound"}}}}}}
````

## POST /api/v1/events/{handle}/questions

> Create a custom question

````json
{"openapi":"3.1.0","info":{"title":"Movemint API","version":"1.0"},"tags":[{"name":"Questions","description":"Manage event-level custom registration questions, including multiple-\nchoice options. The API attaches each question to the event broadly;\nper-sub-event/waitlister scoping is handled via the admin UI.\n"}],"servers":[{"url":"https://www.movemint.cc","description":"Production"}],"security":[{"bearerAuth":[]},{"oauth2":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Pass the access token in the `Authorization` header:\n```\nAuthorization: Bearer YOUR_ACCESS_TOKEN\n```\n"},"oauth2":{"type":"oauth2","description":"OAuth 2.0 authentication using the Authorization Code or Client\nCredentials grant flow.\n","flows":{"authorizationCode":{"authorizationUrl":"https://www.movemint.cc/oauth/authorize","tokenUrl":"https://www.movemint.cc/oauth/token","refreshUrl":"https://www.movemint.cc/oauth/token","scopes":{}},"clientCredentials":{"tokenUrl":"https://www.movemint.cc/oauth/token","scopes":{}}}}},"parameters":{"EventHandle":{"name":"handle","in":"path","required":true,"description":"The unique handle (slug) of the event","schema":{"type":"string"}}},"schemas":{"CreateQuestionRequest":{"type":"object","required":["title","question_type"],"properties":{"title":{"type":"string"},"question_type":{"type":"string","enum":["text","multiple_choice","time_hr_min_second","time_min_second"]},"required":{"type":"boolean"},"options":{"type":"array","description":"Answer options, in the order registrants should see them.","items":{"type":"string"}},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":"string","format":"date-time"}}},"CustomQuestion":{"type":"object","required":["id","question_id","title","question_type","required","order","starts_at","ends_at","options","children"],"properties":{"id":{"type":"integer","format":"int64","description":"TransactableCustomQuestion id (the link row, used for update/delete)."},"question_id":{"type":"integer","format":"int64"},"title":{"type":"string"},"question_type":{"type":"string","enum":["text","multiple_choice","time_hr_min_second","time_min_second"]},"required":{"type":"boolean"},"order":{"type":"integer"},"starts_at":{"type":"string","format":"date-time","nullable":true},"ends_at":{"type":"string","format":"date-time","nullable":true},"options":{"type":"array","description":"Answer options in the order they are shown to registrants.","items":{"$ref":"#/components/schemas/CustomQuestionOption"}},"children":{"type":"array","description":"Conditional child questions revealed by this question's answers. Only multiple-choice questions can have children; empty otherwise.","items":{"$ref":"#/components/schemas/NestedQuestionChild"}}}},"CustomQuestionOption":{"type":"object","required":["id","label"],"properties":{"id":{"type":"integer","format":"int64"},"label":{"type":"string"}}},"NestedQuestionChild":{"type":"object","description":"A conditional (nested) child question shown only when this question is answered with one of the trigger options. References a question that also appears in full elsewhere in the questions list.","required":["link_id","child_question_id","show_when"],"properties":{"link_id":{"type":"integer","format":"int64","description":"NestedQuestionLink id (used to delete the link)."},"child_question_id":{"type":"integer","format":"int64","description":"Question id (the `id` field) of the child question to show."},"show_when":{"type":"array","description":"Parent option labels that reveal the child question.","items":{"type":"string"}}}},"OAuthError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Machine-readable error code"},"error_description":{"type":"string","description":"Human-readable description of the error"}}},"Error":{"type":"object","description":"A generic error response","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}}},"Forbidden":{"description":"Forbidden - user is not an admin of this event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"EventNotFound":{"description":"Event not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/events/{handle}/questions":{"post":{"tags":["Questions"],"summary":"Create a custom question","operationId":"createEventQuestion","parameters":[{"$ref":"#/components/parameters/EventHandle"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateQuestionRequest"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","required":["question"],"properties":{"question":{"$ref":"#/components/schemas/CustomQuestion"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/EventNotFound"},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
````

## GET /api/v1/events/{handle}/questions/{id}

> Get a custom question

````json
{"openapi":"3.1.0","info":{"title":"Movemint API","version":"1.0"},"tags":[{"name":"Questions","description":"Manage event-level custom registration questions, including multiple-\nchoice options. The API attaches each question to the event broadly;\nper-sub-event/waitlister scoping is handled via the admin UI.\n"}],"servers":[{"url":"https://www.movemint.cc","description":"Production"}],"security":[{"bearerAuth":[]},{"oauth2":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Pass the access token in the `Authorization` header:\n```\nAuthorization: Bearer YOUR_ACCESS_TOKEN\n```\n"},"oauth2":{"type":"oauth2","description":"OAuth 2.0 authentication using the Authorization Code or Client\nCredentials grant flow.\n","flows":{"authorizationCode":{"authorizationUrl":"https://www.movemint.cc/oauth/authorize","tokenUrl":"https://www.movemint.cc/oauth/token","refreshUrl":"https://www.movemint.cc/oauth/token","scopes":{}},"clientCredentials":{"tokenUrl":"https://www.movemint.cc/oauth/token","scopes":{}}}}},"parameters":{"EventHandle":{"name":"handle","in":"path","required":true,"description":"The unique handle (slug) of the event","schema":{"type":"string"}},"ResourceId":{"name":"id","in":"path","required":true,"description":"The ID of the resource","schema":{"type":"integer","format":"int64"}}},"schemas":{"CustomQuestion":{"type":"object","required":["id","question_id","title","question_type","required","order","starts_at","ends_at","options","children"],"properties":{"id":{"type":"integer","format":"int64","description":"TransactableCustomQuestion id (the link row, used for update/delete)."},"question_id":{"type":"integer","format":"int64"},"title":{"type":"string"},"question_type":{"type":"string","enum":["text","multiple_choice","time_hr_min_second","time_min_second"]},"required":{"type":"boolean"},"order":{"type":"integer"},"starts_at":{"type":"string","format":"date-time","nullable":true},"ends_at":{"type":"string","format":"date-time","nullable":true},"options":{"type":"array","description":"Answer options in the order they are shown to registrants.","items":{"$ref":"#/components/schemas/CustomQuestionOption"}},"children":{"type":"array","description":"Conditional child questions revealed by this question's answers. Only multiple-choice questions can have children; empty otherwise.","items":{"$ref":"#/components/schemas/NestedQuestionChild"}}}},"CustomQuestionOption":{"type":"object","required":["id","label"],"properties":{"id":{"type":"integer","format":"int64"},"label":{"type":"string"}}},"NestedQuestionChild":{"type":"object","description":"A conditional (nested) child question shown only when this question is answered with one of the trigger options. References a question that also appears in full elsewhere in the questions list.","required":["link_id","child_question_id","show_when"],"properties":{"link_id":{"type":"integer","format":"int64","description":"NestedQuestionLink id (used to delete the link)."},"child_question_id":{"type":"integer","format":"int64","description":"Question id (the `id` field) of the child question to show."},"show_when":{"type":"array","description":"Parent option labels that reveal the child question.","items":{"type":"string"}}}},"OAuthError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Machine-readable error code"},"error_description":{"type":"string","description":"Human-readable description of the error"}}},"Error":{"type":"object","description":"A generic error response","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}}},"Forbidden":{"description":"Forbidden - user is not an admin of this event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"EventNotFound":{"description":"Event not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/events/{handle}/questions/{id}":{"get":{"tags":["Questions"],"summary":"Get a custom question","operationId":"getEventQuestion","parameters":[{"$ref":"#/components/parameters/EventHandle"},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"Question details","content":{"application/json":{"schema":{"type":"object","required":["question"],"properties":{"question":{"$ref":"#/components/schemas/CustomQuestion"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/EventNotFound"}}}}}}
````

## Delete a custom question

> Refused with 422 if registrants have already answered the question, since deleting it would also delete their answers.

````json
{"openapi":"3.1.0","info":{"title":"Movemint API","version":"1.0"},"tags":[{"name":"Questions","description":"Manage event-level custom registration questions, including multiple-\nchoice options. The API attaches each question to the event broadly;\nper-sub-event/waitlister scoping is handled via the admin UI.\n"}],"servers":[{"url":"https://www.movemint.cc","description":"Production"}],"security":[{"bearerAuth":[]},{"oauth2":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Pass the access token in the `Authorization` header:\n```\nAuthorization: Bearer YOUR_ACCESS_TOKEN\n```\n"},"oauth2":{"type":"oauth2","description":"OAuth 2.0 authentication using the Authorization Code or Client\nCredentials grant flow.\n","flows":{"authorizationCode":{"authorizationUrl":"https://www.movemint.cc/oauth/authorize","tokenUrl":"https://www.movemint.cc/oauth/token","refreshUrl":"https://www.movemint.cc/oauth/token","scopes":{}},"clientCredentials":{"tokenUrl":"https://www.movemint.cc/oauth/token","scopes":{}}}}},"parameters":{"EventHandle":{"name":"handle","in":"path","required":true,"description":"The unique handle (slug) of the event","schema":{"type":"string"}},"ResourceId":{"name":"id","in":"path","required":true,"description":"The ID of the resource","schema":{"type":"integer","format":"int64"}}},"responses":{"Unauthorized":{"description":"Unauthorized - invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}}},"Forbidden":{"description":"Forbidden - user is not an admin of this event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"EventNotFound":{"description":"Event not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"OAuthError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Machine-readable error code"},"error_description":{"type":"string","description":"Human-readable description of the error"}}},"Error":{"type":"object","description":"A generic error response","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message"}}}}},"paths":{"/api/v1/events/{handle}/questions/{id}":{"delete":{"tags":["Questions"],"summary":"Delete a custom question","operationId":"deleteEventQuestion","description":"Refused with 422 if registrants have already answered the question, since deleting it would also delete their answers.","parameters":[{"$ref":"#/components/parameters/EventHandle"},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean","enum":[true]}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/EventNotFound"},"422":{"description":"Question has registrant answers and cannot be deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
````

## PATCH /api/v1/events/{handle}/questions/{id}

> Update a custom question

````json
{"openapi":"3.1.0","info":{"title":"Movemint API","version":"1.0"},"tags":[{"name":"Questions","description":"Manage event-level custom registration questions, including multiple-\nchoice options. The API attaches each question to the event broadly;\nper-sub-event/waitlister scoping is handled via the admin UI.\n"}],"servers":[{"url":"https://www.movemint.cc","description":"Production"}],"security":[{"bearerAuth":[]},{"oauth2":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Pass the access token in the `Authorization` header:\n```\nAuthorization: Bearer YOUR_ACCESS_TOKEN\n```\n"},"oauth2":{"type":"oauth2","description":"OAuth 2.0 authentication using the Authorization Code or Client\nCredentials grant flow.\n","flows":{"authorizationCode":{"authorizationUrl":"https://www.movemint.cc/oauth/authorize","tokenUrl":"https://www.movemint.cc/oauth/token","refreshUrl":"https://www.movemint.cc/oauth/token","scopes":{}},"clientCredentials":{"tokenUrl":"https://www.movemint.cc/oauth/token","scopes":{}}}}},"parameters":{"EventHandle":{"name":"handle","in":"path","required":true,"description":"The unique handle (slug) of the event","schema":{"type":"string"}},"ResourceId":{"name":"id","in":"path","required":true,"description":"The ID of the resource","schema":{"type":"integer","format":"int64"}}},"schemas":{"UpdateQuestionRequest":{"type":"object","properties":{"title":{"type":"string"},"question_type":{"type":"string","enum":["text","multiple_choice","time_hr_min_second","time_min_second"]},"required":{"type":"boolean"},"options":{"type":"array","description":"Replaces the full option list, in the order registrants should see them. Options matched by text keep their existing id (and any nesting triggers or CRM filters pointing at them) and are repositioned to match; unlisted options are removed.","items":{"type":"string"}},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":"string","format":"date-time"}}},"CustomQuestion":{"type":"object","required":["id","question_id","title","question_type","required","order","starts_at","ends_at","options","children"],"properties":{"id":{"type":"integer","format":"int64","description":"TransactableCustomQuestion id (the link row, used for update/delete)."},"question_id":{"type":"integer","format":"int64"},"title":{"type":"string"},"question_type":{"type":"string","enum":["text","multiple_choice","time_hr_min_second","time_min_second"]},"required":{"type":"boolean"},"order":{"type":"integer"},"starts_at":{"type":"string","format":"date-time","nullable":true},"ends_at":{"type":"string","format":"date-time","nullable":true},"options":{"type":"array","description":"Answer options in the order they are shown to registrants.","items":{"$ref":"#/components/schemas/CustomQuestionOption"}},"children":{"type":"array","description":"Conditional child questions revealed by this question's answers. Only multiple-choice questions can have children; empty otherwise.","items":{"$ref":"#/components/schemas/NestedQuestionChild"}}}},"CustomQuestionOption":{"type":"object","required":["id","label"],"properties":{"id":{"type":"integer","format":"int64"},"label":{"type":"string"}}},"NestedQuestionChild":{"type":"object","description":"A conditional (nested) child question shown only when this question is answered with one of the trigger options. References a question that also appears in full elsewhere in the questions list.","required":["link_id","child_question_id","show_when"],"properties":{"link_id":{"type":"integer","format":"int64","description":"NestedQuestionLink id (used to delete the link)."},"child_question_id":{"type":"integer","format":"int64","description":"Question id (the `id` field) of the child question to show."},"show_when":{"type":"array","description":"Parent option labels that reveal the child question.","items":{"type":"string"}}}},"OAuthError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Machine-readable error code"},"error_description":{"type":"string","description":"Human-readable description of the error"}}},"Error":{"type":"object","description":"A generic error response","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}}},"Forbidden":{"description":"Forbidden - user is not an admin of this event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"EventNotFound":{"description":"Event not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/events/{handle}/questions/{id}":{"patch":{"tags":["Questions"],"summary":"Update a custom question","operationId":"updateEventQuestion","parameters":[{"$ref":"#/components/parameters/EventHandle"},{"$ref":"#/components/parameters/ResourceId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateQuestionRequest"}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","required":["question"],"properties":{"question":{"$ref":"#/components/schemas/CustomQuestion"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/EventNotFound"},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
````

## Create a nested (conditional) question link

> Reveal a child question only when the parent multiple-choice question is answered with one of the trigger options. The parent must be a multiple-choice question, and both parent and child must be event-level questions on this event.

````json
{"openapi":"3.1.0","info":{"title":"Movemint API","version":"1.0"},"tags":[{"name":"Questions","description":"Manage event-level custom registration questions, including multiple-\nchoice options. The API attaches each question to the event broadly;\nper-sub-event/waitlister scoping is handled via the admin UI.\n"}],"servers":[{"url":"https://www.movemint.cc","description":"Production"}],"security":[{"bearerAuth":[]},{"oauth2":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Pass the access token in the `Authorization` header:\n```\nAuthorization: Bearer YOUR_ACCESS_TOKEN\n```\n"},"oauth2":{"type":"oauth2","description":"OAuth 2.0 authentication using the Authorization Code or Client\nCredentials grant flow.\n","flows":{"authorizationCode":{"authorizationUrl":"https://www.movemint.cc/oauth/authorize","tokenUrl":"https://www.movemint.cc/oauth/token","refreshUrl":"https://www.movemint.cc/oauth/token","scopes":{}},"clientCredentials":{"tokenUrl":"https://www.movemint.cc/oauth/token","scopes":{}}}}},"parameters":{"EventHandle":{"name":"handle","in":"path","required":true,"description":"The unique handle (slug) of the event","schema":{"type":"string"}}},"schemas":{"CreateNestedQuestionLinkRequest":{"type":"object","required":["child_question_id","answer_matches"],"properties":{"child_question_id":{"type":"integer","format":"int64","description":"Question id (the `id` field of an event-level question) to reveal when the parent is answered with one of `answer_matches`."},"answer_matches":{"type":"array","minItems":1,"description":"Parent options that trigger the child. Each entry is either an option id (integer) or an exact option label (string). Errors if an entry matches no option or a label is ambiguous. Each parent option can be used by at most one link.","items":{"oneOf":[{"type":"integer","format":"int64"},{"type":"string"}]}}}},"NestedQuestionLink":{"type":"object","required":["link_id","parent_question_id","child_question_id","show_when"],"properties":{"link_id":{"type":"integer","format":"int64"},"parent_question_id":{"type":"integer","format":"int64","description":"Question id (the `id` field) of the parent question."},"child_question_id":{"type":"integer","format":"int64","description":"Question id (the `id` field) of the child question."},"show_when":{"type":"array","description":"Parent option labels that reveal the child question.","items":{"type":"string"}}}},"OAuthError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Machine-readable error code"},"error_description":{"type":"string","description":"Human-readable description of the error"}}},"Error":{"type":"object","description":"A generic error response","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}}},"Forbidden":{"description":"Forbidden - user is not an admin of this event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"EventNotFound":{"description":"Event not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/v1/events/{handle}/questions/{question_id}/nested_question_links":{"post":{"tags":["Questions"],"summary":"Create a nested (conditional) question link","description":"Reveal a child question only when the parent multiple-choice question is answered with one of the trigger options. The parent must be a multiple-choice question, and both parent and child must be event-level questions on this event.","operationId":"createNestedQuestionLink","parameters":[{"$ref":"#/components/parameters/EventHandle"},{"name":"question_id","in":"path","required":true,"description":"Question id (the `id` field) of the parent question.","schema":{"type":"integer","format":"int64"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateNestedQuestionLinkRequest"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","required":["nested_question_link"],"properties":{"nested_question_link":{"$ref":"#/components/schemas/NestedQuestionLink"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/EventNotFound"},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
````

## DELETE /api/v1/events/{handle}/questions/{question\_id}/nested\_question\_links/{id}

> Delete a nested (conditional) question link

````json
{"openapi":"3.1.0","info":{"title":"Movemint API","version":"1.0"},"tags":[{"name":"Questions","description":"Manage event-level custom registration questions, including multiple-\nchoice options. The API attaches each question to the event broadly;\nper-sub-event/waitlister scoping is handled via the admin UI.\n"}],"servers":[{"url":"https://www.movemint.cc","description":"Production"}],"security":[{"bearerAuth":[]},{"oauth2":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Pass the access token in the `Authorization` header:\n```\nAuthorization: Bearer YOUR_ACCESS_TOKEN\n```\n"},"oauth2":{"type":"oauth2","description":"OAuth 2.0 authentication using the Authorization Code or Client\nCredentials grant flow.\n","flows":{"authorizationCode":{"authorizationUrl":"https://www.movemint.cc/oauth/authorize","tokenUrl":"https://www.movemint.cc/oauth/token","refreshUrl":"https://www.movemint.cc/oauth/token","scopes":{}},"clientCredentials":{"tokenUrl":"https://www.movemint.cc/oauth/token","scopes":{}}}}},"parameters":{"EventHandle":{"name":"handle","in":"path","required":true,"description":"The unique handle (slug) of the event","schema":{"type":"string"}},"ResourceId":{"name":"id","in":"path","required":true,"description":"The ID of the resource","schema":{"type":"integer","format":"int64"}}},"responses":{"Unauthorized":{"description":"Unauthorized - invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}}},"Forbidden":{"description":"Forbidden - user is not an admin of this event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"EventNotFound":{"description":"Event not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"OAuthError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Machine-readable error code"},"error_description":{"type":"string","description":"Human-readable description of the error"}}},"Error":{"type":"object","description":"A generic error response","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message"}}}}},"paths":{"/api/v1/events/{handle}/questions/{question_id}/nested_question_links/{id}":{"delete":{"tags":["Questions"],"summary":"Delete a nested (conditional) question link","operationId":"deleteNestedQuestionLink","parameters":[{"$ref":"#/components/parameters/EventHandle"},{"name":"question_id","in":"path","required":true,"description":"Question id (the `id` field) of the parent question.","schema":{"type":"integer","format":"int64"}},{"$ref":"#/components/parameters/ResourceId"}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean","enum":[true]}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/EventNotFound"}}}}}}
````