Update Question - Plugixa Exam

PUT /plugixa-exam/v1/questions/{id}

Change some or all of a question’s fields. Fields you leave out keep their stored values.

Scope questions:write; the token’s user needs the questions:edit permission, or questions:edit.own when the question was created by that user.

Request

PUT https://your-site.example/wp-json/plugixa-exam/v1/questions/12

Path parameters

Request body

Content type: application/json

The same fields as Create Question, with the same rules. None is required: send only what changes.

The stored question, options included, is overlaid with the fields you send, and the result is checked like a new question. Every successful update raises version by one and saves the new version to the question’s history, even when nothing changed.

Note. Unlike Update Subject, which replaces the whole subject, this endpoint merges: an omitted published keeps its value. Sending options, though, replaces the list, so include the id of every option you want to keep.

{
  "difficulty": 3,
  "options": [
    { "id": 41, "option_text": "Paris", "is_correct": true },
    { "id": 42, "option_text": "Lyon", "is_correct": false },
    { "option_text": "Toulouse", "is_correct": false }
  ]
}

Responses

200 OK. data is the updated question.

{
  "success": true,
  "data": {
    "id": 12,
    "subject_id": 4,
    "question_type": "mcq_single",
    "title": "Capital of France",
    "slug": "capital-of-france",
    "stem": "<p>What is the capital of France?</p>",
    "difficulty": 3,
    "default_points": 1,
    "answer_key": { "negative_marking": false, "min_score": 0 },
    "explanation": "<p>Paris is the capital of France.</p>",
    "shuffle_options": true,
    "published": true,
    "version": 4,
    "approval_status": "approved",
    "rubric": null,
    "custom_fields": null,
    "render_hint": null,
    "created_at": "2026-11-10 14:05:00",
    "modified_at": "2026-11-12 09:30:00",
    "created_by": 1,
    "modified_by": 1,
    "deleted_at": null,
    "options": [
      { "id": 41, "question_id": 12, "ordering": 1, "option_text": "Paris", "is_correct": true, "match_key": null, "feedback": null },
      { "id": 42, "question_id": 12, "ordering": 2, "option_text": "Lyon", "is_correct": false, "match_key": null, "feedback": null },
      { "id": 44, "question_id": 12, "ordering": 3, "option_text": "Toulouse", "is_correct": false, "match_key": null, "feedback": null }
    ],
    "tag_ids": [5, 8]
  }
}

The other fields are as in Get Question.

Errors

Plus the errors every endpoint can return.

Examples

curl -s -X PUT "https://your-site.example/wp-json/plugixa-exam/v1/questions/12" \
  -H "Authorization: Bearer $PLUGIXA_EXAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"difficulty":3,"published":false}'

<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-exam/v1/questions/12');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('PLUGIXA_EXAM_TOKEN'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        'difficulty' => 3,
        'published'  => false,
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

const response = await fetch('https://your-site.example/wp-json/plugixa-exam/v1/questions/12', {
  method: 'PUT',
  headers: {
    'Authorization': `Bearer ${process.env.PLUGIXA_EXAM_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ difficulty: 3, published: false }),
});
const { data } = await response.json();