Docs Rizler

Categories

Create Quiz

POSThttps://app.rizzdial.com/api/knowledge-hub/categories/{categoryId}/quizzes/create
Create Quiz
curl --request POST \
  --url https://app.rizzdial.com/api/knowledge-hub/categories/<categoryId>/quizzes/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --data 'title=<string>' \
  --data 'comment_status=<string>' \
  --data 'status=<string>' \
  --data 'questions=<string>' \
  --data 'description=<string>' \
  --data passing_grade=123 \
  --data 'quiz_thumbnail=<string>' \
  --data requires_passing_grade=true
{
  "data": {
    "id": "MQ==",
    "title": "Week 1 check",
    "questions": []
  },
  "message": "Quiz created successfully.",
  "success": true
}

Create Quiz#

Adds a quiz. max_attempts is always 1. Passing score is passing_grade (default 70) when requires_passing_grade is true, otherwise 0. Optional quiz_thumbnail jpeg/png/jpg/gif, max 2 MB. Requires manage-knowledge-hub-quizzes.

Authorizationstringheaderrequired

Bearer token in the format: Bearer {access_token}

categoryIdstringpathrequired

Base64 id from the matching list or builder. A raw numeric id is also accepted.

titlestringbodyrequired

Title. Max 255 characters

comment_statusstringbodyrequired

enabled, hidden, or locked

descriptionstringbody

Optional description

statusstringbody

published or draft. Default draft

requires_passing_gradebooleanbody

When true, passing_score uses passing_grade

passing_gradeintegerbody

0–100. Default 70 when a passing grade is required

pass_messagestringbody

Shown on pass

fail_messagestringbody

Shown on fail

questionsarraybody

New questions. Each: text, type (single_choice default or multi), choices[].text, correct_answer (single) or correct_answers (multi)

quiz_thumbnailfilebody

Optional thumbnail

curl --request POST \
  --url https://app.rizzdial.com/api/knowledge-hub/categories/MQ==/quizzes/create \
  --header 'Authorization: Bearer {{bearer_token}}' \
  --form 'title=Week 1 check' \
  --form 'comment_status=enabled' \
  --form 'status=draft'
messagestring

Quiz created successfully.

dataobject

Quiz with base64 id and questions.options