Creating Assessments

Via the dashboard

1. Go to Assessments → New Assessment
2. Enter a title, optional description, and optional time limit
3. Click Create — the assessment starts in DRAFT status
4. Add stages using + Add Stage
5. Configure each stage (questions, prompts, AI settings)
6. Click Publish to make it live
7. Share the assessment link or invite candidates by email

Via the API

POST /v1/assessments
Authorization: Bearer <token>
Content-Type: application/json

{
  "title": "Senior Frontend Engineer",
  "description": "A 3-stage technical assessment",
  "timeLimitMinutes": 90,
  "passingScore": 70
}

// Add a stage
POST /v1/assessments/:id/stages
{
  "type": "MCQ",
  "title": "JavaScript Fundamentals",
  "order": 1,
  "config": {
    "questions": [
      {
        "text": "What does 'use strict' do?",
        "options": ["Enables strict mode", "Imports a module", "Declares a variable", "Throws an error"],
        "correctIndex": 0,
        "points": 1
      }
    ]
  }
}

// Publish
POST /v1/assessments/:id/publish

Sharing an assessment

Once published, the assessment is accessible at:

https://assessment.yourdomain.com/a/{assessmentSlug}

You can also invite specific candidates by email:

POST /v1/candidates/:assessmentId/invite
{
  "name": "Jane Smith",
  "email": "jane@example.com"
}

// Candidate receives an email with a unique, one-time access link

Duplicating an assessment

Clone an existing assessment with all its stages:

POST /v1/assessments/:id/duplicate

Or use Duplicate from the assessment's action menu in the dashboard.

Reordering stages

POST /v1/assessments/:id/reorder-stages
{
  "stageIds": ["stage_c", "stage_a", "stage_b"]
}
// Stages will be shown in the given order

Assessment limits

• FREE plan — maximum 3 published assessments at a time. Archived assessments do not count toward the limit.
• PRO plan — no limit.

Learn about stage types →

Inviting candidates →