Candidate | TrueTest Documentation

Retrieves all exams of the authenticated user.

get

Retrieves all exams of the authenticated user, including their results.

Authorizations

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Responses

200

OK

application/json

401

Unauthorized

application/json

500

Internal Server Error

application/json

get

/Candidate/Exams

GET /api/Candidate/Exams 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"
    },
    "result": {
      "totalScore": 1,
      "problemSolvingScore": 1,
      "writtenScore": 1,
      "mcqScore": 1,
      "startedAt": "2026-01-26T11:40:57.252Z",
      "submittedAt": "2026-01-26T11:40:57.252Z",
      "hasCheated": true,
      "isReviewed": true
    }
  }
]

Starts an exam for the authenticated user.

post

Starts a specific exam for the authenticated user, providing exam details, questions, and prior submissions.

Authorizations

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Path parameters

examIdstring · uuidRequired

Identifier of the exam to start.

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

500

Internal Server Error

application/json

post

/Candidate/Exam/Start/{examId}

POST /api/Candidate/Exam/Start/{examId} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "examId": "123e4567-e89b-12d3-a456-426614174000",
  "startedAt": "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"
        }
      }
    ]
  },
  "submits": {
    "problem": [
      {
        "questionId": "123e4567-e89b-12d3-a456-426614174000",
        "problemSubmissionId": "123e4567-e89b-12d3-a456-426614174000",
        "code": "text",
        "language": "java"
      }
    ],
    "written": [
      {
        "questionId": "123e4567-e89b-12d3-a456-426614174000",
        "writtenSubmissionId": "123e4567-e89b-12d3-a456-426614174000",
        "answer": "text"
      }
    ],
    "mcq": [
      {
        "questionId": "123e4567-e89b-12d3-a456-426614174000",
        "mcqSubmissionId": "123e4567-e89b-12d3-a456-426614174000",
        "answerOptions": "text"
      }
    ]
  }
}

Creates or updates a problem-solving submission for the authenticated user.

put

Creates or updates a problem-solving submission and returns the results of test code execution.

Authorizations

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Body

examIdstring · uuidOptional

questionIdstring · uuidOptional

codestring | nullableOptional

languagestring · enumOptionalPossible values:

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

put

/Candidate/Submit/Problem/Save

PUT /api/Candidate/Submit/Problem/Save HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 133

{
  "examId": "123e4567-e89b-12d3-a456-426614174000",
  "questionId": "123e4567-e89b-12d3-a456-426614174000",
  "code": "text",
  "language": "java"
}

[
  {
    "testCaseId": "123e4567-e89b-12d3-a456-426614174000",
    "isAccepted": true,
    "receivedOutput": "text",
    "errorMessage": "text",
    "exception": "text",
    "executionTime": 1
  }
]

Creates or updates a written submission for the authenticated user.

put

Creates or updates a written submission.

Authorizations

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Body

examIdstring · uuidOptional

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

put

/Candidate/Submit/Written/Save

PUT /api/Candidate/Submit/Written/Save HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 144

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

No content

Creates or updates an MCQ submission for the authenticated user.

put

Creates or updates a multiple-choice question (MCQ) submission.

Authorizations

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Body

examIdstring · uuidOptional

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

put

/Candidate/Submit/Mcq/Save

PUT /api/Candidate/Submit/Mcq/Save HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 151

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

No content

Submits the completed exam for the authenticated user.

patch

Submits the completed exam for the authenticated user.

Authorizations

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Path parameters

examIdstring · uuidRequired

Identifier of the exam to submit.

Responses

200

OK

No content

400

Bad Request

application/json

401

Unauthorized

application/json

500

Internal Server Error

application/json

patch

/Candidate/Submit/Exam/{examId}

PATCH /api/Candidate/Submit/Exam/{examId} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Executes and tests code for a given problem-solving question.

post

Executes and tests code for a given problem-solving question.

Authorizations

AuthorizationstringRequired

🗝️ Admin Account

eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJBY2NvdW50SWQiOiIxMTExMTExMS0xMTExLTExMTEtMTExMS0xMTExMTExMTExMTEiLCJVc2VybmFtZSI6ImFkbWluIiwiRW1haWwiOiJhZG1pbkB0cnVldGVzdC50ZWNoIiwiaHR0cDovL3NjaGVtYXMubWljcm9zb2Z0LmNvbS93cy8yMDA4LzA2L2lkZW50aXR5L2NsYWltcy9yb2xlIjpbIkNhbmRpZGF0ZSIsIkFkbWluIl0sIlBlcm1pc3Npb24iOlsiQWNjZXNzT3duRXhhbXMiLCJTdWJtaXRBbnN3ZXJzIiwiUnVuQ29kZSIsIk1hbmFnZU93blByb2ZpbGUiLCJNYW5hZ2VBY2NvdW50cyIsIlZpZXdFeGFtcyIsIk1hbmFnZUV4YW1zIiwiTWFuYWdlUXVlc3Rpb25zIiwiVmlld1N1Ym1pc3Npb25zIiwiUmV2aWV3U3VibWlzc2lvbiJdLCJleHAiOjQ4OTkwMzMxOTUsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3QiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0In0.VBPngQIwsybHrwZPYMA5sNpWew3S9_W7cDdpAD4mDyM

Body

codestring | nullableOptional

inputstring | nullableOptional

languageIdstring · enumOptionalPossible values:

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

500

Internal Server Error

application/json

post

/Candidate/RunAnyCode

POST /api/Candidate/RunAnyCode HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "code": "text",
  "input": "text",
  "languageId": "java"
}

{
  "status": "text",
  "stdout": "text",
  "stdin": "text",
  "stderr": "text",
  "exception": "text",
  "executionTime": 1
}

hashtagRetrieves all exams of the authenticated user.

hashtagStarts an exam for the authenticated user.

hashtagCreates or updates a problem-solving submission for the authenticated user.

hashtagCreates or updates a written submission for the authenticated user.

hashtagCreates or updates an MCQ submission for the authenticated user.

hashtagSubmits the completed exam for the authenticated user.

hashtagExecutes and tests code for a given problem-solving question.

Retrieves all exams of the authenticated user.

Starts an exam for the authenticated user.

Creates or updates a problem-solving submission for the authenticated user.

Creates or updates a written submission for the authenticated user.

Creates or updates an MCQ submission for the authenticated user.

Submits the completed exam for the authenticated user.

Executes and tests code for a given problem-solving question.