Delete quiz question

Requires an inactive draft. Returns the whole updated quiz. Historical answers, attempts and logs remain even when referencing the deleted question.

Requires a community API key with quizzes permission; personal keys are rejected. Tenant comes from authentication. Unknown/system-owned body fields are rejected. JSON UTF-8 bodies are limited to 1 MiB. All responses use Cache-Control: no-store. Question mutations require a previous successful separate PATCH {"isActive":false}. Concurrent publication/configuration changes return 409 QUIZ_CONFLICT; fetch current detail before retrying.

DELETE /apis/v1/quizzes/{quizId}/questions/{questionId}

Path parameters: quizId — required 24-character MongoDB id in the authenticated community; example 507f1f77bcf86cd799439011. questionId — required stable embedded string id; example q2. No body/query params.

Example: DELETE /apis/v1/quizzes/507f1f77bcf86cd799439011/questions/q2

First unpublish through a separate successful quiz PATCH {"isActive":false}. Published deletion returns 409. A concurrent publication/configuration change returns 409 without overwriting it; fetch detail before retrying.

200 returns the whole updated quiz, with q2 removed from configuration.questions. Historical attempts, answers and mini-game logs remain unchanged. Deleting the last draft question is allowed.

Errors: 400 invalid quizId, 401 authentication, 403 permission, 404 QUIZ_NOT_FOUND/QUESTION_NOT_FOUND, 409 QUIZ_PUBLISHED/QUIZ_CONFLICT, 429 configured rate limit, 500 safe failure.

{ "meta": { "status": "success", "statusCode": 200, "requestId": "req_example" }, "message": "Quiz question deleted success.", "data": { "_id": "507f1f77bcf86cd799439011", "serverId": "507f191e810c19729de860ea", "type": "quiz", "name": "Product knowledge", "description": "", "timezone": "UTC", "isActive": false, "viewPermission": { "roles": [], "users": [] }, "useServerTheme": true, "customThemes": [], "configuration": { "quizMode": "knowledge", "startScreen": { "title": "Start Quiz", "description": "", "startButtonText": "Start the Quiz" }, "endScreen": { "title": "You have completed this quiz.", "description": "", "completeButtonText": "Done", "reAttemptButtonText": "Try Again", "showUserScore": true }, "settings": { "showQuizProgress": false, "backNavigation": false, "questionSkips": false, "numberOfAttempts": 1, "pointsPerQuestion": 1, "answerConfiguration": { "mode": "score_only" }, "showUserScore": true, "passingMarkEnabled": true, "passingPercentage": 50 }, "questions": [ { "id": "q1", "type": "single_select", "question": "Which option is correct?", "options": [ { "id": "a", "label": "A", "value": "A" }, { "id": "b", "label": "B", "value": "B" } ], "correctAnswer": "a" } ] }, "createdAt": "2026-10-03T00:00:00.000Z", "updatedAt": "2026-10-03T00:00:00.000Z" } }

Request

Responses