Exam

Retrieves a list of all exams.

get

Retrieves a list of all exams.

Authorizations

Bearer

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Responses

200

OK

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

get

/Exam

HTTPcURLJavaScriptPython

GET /api/Exam HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "examId": "123e4567-e89b-12d3-a456-426614174000",
    "title": "text",
    "description": "text",
    "totalPoints": 1,
    "problemSolvingPoints": 1,
    "writtenPoints": 1,
    "mcqPoints": 1,
    "durationMinutes": 1,
    "isPublished": true,
    "status": "text",
    "opensAt": "2026-01-26T11:40:57.252Z",
    "closesAt": "2026-01-26T11:40:57.252Z"
  }
]

Retrieves a specific exam along with all its associated questions.

get

Retrieves a specific exam along with all its associated questions.

Authorizations

Bearer

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Path parameters

examIdstring · uuidRequired

The unique identifier of the exam to retrieve.

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/Exam/{examId}

HTTPcURLJavaScriptPython

GET /api/Exam/{examId} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "exam": {
    "examId": "123e4567-e89b-12d3-a456-426614174000",
    "title": "text",
    "description": "text",
    "totalPoints": 1,
    "problemSolvingPoints": 1,
    "writtenPoints": 1,
    "mcqPoints": 1,
    "durationMinutes": 1,
    "isPublished": true,
    "status": "text",
    "opensAt": "2026-01-26T11:40:57.252Z",
    "closesAt": "2026-01-26T11:40:57.252Z"
  },
  "questions": {
    "problem": [
      {
        "questionId": "123e4567-e89b-12d3-a456-426614174000",
        "examId": "123e4567-e89b-12d3-a456-426614174000",
        "questionType": "ProblemSolving",
        "statementMarkdown": "text",
        "points": 1,
        "difficultyType": "Easy",
        "testCases": [
          {
            "testCaseId": "123e4567-e89b-12d3-a456-426614174000",
            "input": "text",
            "output": "text"
          }
        ]
      }
    ],
    "written": [
      {
        "questionId": "123e4567-e89b-12d3-a456-426614174000",
        "examId": "123e4567-e89b-12d3-a456-426614174000",
        "questionType": "ProblemSolving",
        "hasLongAnswer": true,
        "statementMarkdown": "text",
        "score": 1,
        "difficultyType": "Easy"
      }
    ],
    "mcq": [
      {
        "questionId": "123e4567-e89b-12d3-a456-426614174000",
        "examId": "123e4567-e89b-12d3-a456-426614174000",
        "questionType": "ProblemSolving",
        "statementMarkdown": "text",
        "score": 1,
        "difficultyType": "Easy",
        "mcqOption": {
          "option1": "text",
          "option2": "text",
          "option3": "text",
          "option4": "text",
          "isMultiSelect": true,
          "answerOptions": "text"
        }
      }
    ]
  }
}

Creates a new exam based on the provided details.

post

Creates a new exam based on the provided details.

Authorizations

Bearer

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Body

application/json

titlestring | nullableOptional

descriptionstring | nullableOptional

durationMinutesinteger · int32Optional

totalPointsnumber · doubleOptional

opensAtstring · date-timeOptional

closesAtstring · date-timeOptional

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

post

/Exam/Create

HTTPcURLJavaScriptPython

POST /api/Exam/Create HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 148

{
  "title": "text",
  "description": "text",
  "durationMinutes": 1,
  "totalPoints": 1,
  "opensAt": "2026-01-26T11:40:57.252Z",
  "closesAt": "2026-01-26T11:40:57.252Z"
}

{
  "examId": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "description": "text",
  "totalPoints": 1,
  "problemSolvingPoints": 1,
  "writtenPoints": 1,
  "mcqPoints": 1,
  "durationMinutes": 1,
  "isPublished": true,
  "status": "text",
  "opensAt": "2026-01-26T11:40:57.252Z",
  "closesAt": "2026-01-26T11:40:57.252Z"
}

Updates the details of an existing exam.

patch

Updates the details of an existing exam.

Authorizations

Bearer

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Body

application/json

examIdstring · uuidOptional

titlestring | nullableOptional

descriptionstring | nullableOptional

durationMinutesinteger · int32 | nullableOptional

totalPointsnumber · double | nullableOptional

opensAtstring · date-time | nullableOptional

closesAtstring · date-time | nullableOptional

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

500

Internal Server Error

application/json

patch

/Exam/Update

HTTPcURLJavaScriptPython

PATCH /api/Exam/Update HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 196

{
  "examId": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "description": "text",
  "durationMinutes": 1,
  "totalPoints": 1,
  "opensAt": "2026-01-26T11:40:57.252Z",
  "closesAt": "2026-01-26T11:40:57.252Z"
}

{
  "examId": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "description": "text",
  "totalPoints": 1,
  "problemSolvingPoints": 1,
  "writtenPoints": 1,
  "mcqPoints": 1,
  "durationMinutes": 1,
  "isPublished": true,
  "status": "text",
  "opensAt": "2026-01-26T11:40:57.252Z",
  "closesAt": "2026-01-26T11:40:57.252Z"
}

Publishes an exam, making it available to candidates.

post

Publishes an exam, making it available to candidates.

Authorizations

Bearer

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Query parameters

examIdstring · uuidOptional

The unique identifier of the exam to publish.

Responses

200

OK

No content

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

500

Internal Server Error

application/json

post

/Exam/Publish

HTTPcURLJavaScriptPython

POST /api/Exam/Publish HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Invites a list of candidates to participate in a specific exam.

post

Invites a list of candidates to participate in a specific exam.

Authorizations

Bearer

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Body

application/json

examIdstring · uuidOptional

emailsstring[] | nullableOptional

Responses

200

OK

No content

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

post

/Exam/Invite/Candidates

HTTPcURLJavaScriptPython

POST /api/Exam/Invite/Candidates HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "examId": "123e4567-e89b-12d3-a456-426614174000",
  "emails": [
    "text"
  ]
}

No content

Deletes a specific exam.

delete

Deletes a specific exam.

Authorizations

Bearer

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Path parameters

examIdstring · uuidRequired

The unique identifier of the exam to delete.

Responses

200

OK

No content

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

500

Internal Server Error

application/json

delete

/Exam/Delete/{examId}

HTTPcURLJavaScriptPython

DELETE /api/Exam/Delete/{examId} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content