Create Question - Plugixa Exam

POST /plugixa-exam/v1/questions

Create a question of any registered type, with its options and answer key.

Scope questions:write; the token’s user needs the questions:create permission.

Request

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

Request body

Content type: application/json

The question starts at version 1, and that first version is saved to its history.

Note. published defaults to false. A question you create without sending published: true does not appear on the site until you publish it.

{
  "title": "Capital of France",
  "question_type": "mcq_single",
  "subject_id": 4,
  "stem": "<p>What is the capital of France?</p>",
  "explanation": "<p>Paris is the capital of France.</p>",
  "difficulty": 2,
  "default_points": 1,
  "options": [
    { "option_text": "Paris", "is_correct": true },
    { "option_text": "Lyon", "is_correct": false },
    { "option_text": "Marseille", "is_correct": false }
  ],
  "answer_key": { "negative_marking": false, "min_score": 0 },
  "published": true,
  "tag_ids": [5]
}

Options

Each entry of options:

Options are saved in the order you send them.

Answer key by type

answer_key is cleaned per type before it is saved, so unknown keys are dropped and missing keys take their defaults.

Other types define their own answer key shape in the module that registers them.

{
  "title": "Boiling point of water",
  "question_type": "short_answer",
  "stem": "<p>At sea level, water boils at how many degrees Celsius?</p>",
  "answer_key": {
    "accepted": ["100"],
    "numeric": true,
    "tolerance": 0.5
  }
}

Question types

The five built-in types are mcq_single, mcq_multiple, true_false, short_answer and essay. Modules add cloze and image_choice, and, with Plugixa Exam Pro PRO, ordering, matching, emq, file_upload, hotspot, image_match and range. List Question Types returns what the site accepts right now.

Responses

201 Created. data is the new 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": 2,
    "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": 1,
    "approval_status": "approved",
    "rubric": null,
    "custom_fields": null,
    "render_hint": null,
    "created_at": "2026-11-12 09:30: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": 43, "question_id": 12, "ordering": 3, "option_text": "Marseille", "is_correct": false, "match_key": null, "feedback": null }
    ],
    "tag_ids": [5]
  }
}

Errors

Plus the errors every endpoint can return.

Examples

curl -s -X POST "https://your-site.example/wp-json/plugixa-exam/v1/questions" \
  -H "Authorization: Bearer $PLUGIXA_EXAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Capital of France","question_type":"mcq_single","subject_id":4,"stem":"<p>What is the capital of France?</p>","options":[{"option_text":"Paris","is_correct":true},{"option_text":"Lyon","is_correct":false},{"option_text":"Marseille","is_correct":false}],"published":true}'

<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-exam/v1/questions');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('PLUGIXA_EXAM_TOKEN'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        'title'         => 'Capital of France',
        'question_type' => 'mcq_single',
        'subject_id'    => 4,
        'stem'          => '<p>What is the capital of France?</p>',
        'options'       => [
            ['option_text' => 'Paris', 'is_correct' => true],
            ['option_text' => 'Lyon', 'is_correct' => false],
            ['option_text' => 'Marseille', 'is_correct' => false],
        ],
        'published'     => true,
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

const response = await fetch('https://your-site.example/wp-json/plugixa-exam/v1/questions', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.PLUGIXA_EXAM_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Capital of France',
    question_type: 'mcq_single',
    subject_id: 4,
    stem: '<p>What is the capital of France?</p>',
    options: [
      { option_text: 'Paris', is_correct: true },
      { option_text: 'Lyon', is_correct: false },
      { option_text: 'Marseille', is_correct: false },
    ],
    published: true,
  }),
});
const { data } = await response.json();