Documentation Index
Fetch the complete documentation index at: https://mintlify.com/chamals3n4/OpenATS/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Technical Assessments in OpenATS help you objectively evaluate candidate skills before investing time in interviews. Create custom tests with multiple question types, automatic scoring, and pass/fail thresholds.Assessment Basics
Creating an Assessment
Build assessments with these core properties:Title & Description
Clear name and overview (e.g., “Senior React Developer Test”)
Time Limit
Maximum time in minutes for completion (e.g., 60 minutes)
Pass Score
Minimum percentage required to pass (e.g., 70%)
Questions
Add multiple questions with different types and point values
Time limits are enforced strictly. Once started, candidates must complete the assessment within the allocated time or it will auto-submit.
Assessment Questions
Add questions to evaluate specific skills or knowledge:Question Types
Short Answer
Open-ended text responses for:- Code snippets or solutions
- Explanation of concepts
- Problem-solving approaches
- Architecture design descriptions
Multiple Choice
Questions with predefined answer options:- Technical knowledge verification
- Best practices understanding
- Tool/framework familiarity
- Debugging scenarios
Multiple choice questions are automatically scored based on the correct answers you define.
Creating Multiple Choice Questions
Multiple choice questions require at least 2 options:Option Configuration
Each option includes:| Property | Description | Example |
|---|---|---|
| Label | The answer text | ”Use async/await” |
| Is Correct | Whether this is a right answer | true or false |
| Position | Display order | 1, 2, 3… |
Point System & Scoring
Assigning Points
Weight questions based on difficulty or importance:Total Score Calculation
OpenATS tracks three score values:Raw Score
Total points earned by candidate
Total Possible
Sum of all question point values
Percentage
(Raw Score ÷ Total Possible) × 100
Pass/Fail Determination
Candidate Assessment Attempts
Sending Assessments
Assessments are triggered when candidates move to assessment-enabled pipeline stages:Attempt Lifecycle
- Pending
- Started
- Completed
- Expired
Status: Invitation sent, not yet startedActions:
- Candidate can access via unique token
- Link expires after configured time
- No time counting down yet
Unique Assessment Tokens
Each assessment attempt includes:- Unique token: Secure, unguessable access code
- Expiration time: When the invitation link becomes invalid
- Single use: Token cannot be reused after completion
Recording Candidate Information
When candidates access assessments, they may need to verify their identity:Name Confirmation
Candidate enters their full nameStored as
candidateNameInputEmail Verification
Candidate confirms email addressStored as
candidateEmailInputThis identity verification helps ensure the right person completed the assessment, especially important for remote testing.
Viewing Assessment Results
Access comprehensive results for each attempt:Attempt Summary
- Candidate information (name, email)
- Start time and completion time
- Duration taken
- Raw score, total possible, percentage
- Pass/fail status
- Overall attempt status
Individual Answers
For each question:- Question text and type
- Candidate’s answer (text or selected options)
- Points earned vs. points possible
- For multiple choice: correct/incorrect indication
Job Custom Questions
In addition to formal assessments, add screening questions directly to job applications:Question Configuration
Question Text
The question candidates see on the application form
Question Type
Short Answer or Multiple Choice
Required
Whether candidates must answer to submit application
Position
Order the question appears on the form
Custom vs. Assessment Questions
| Feature | Custom Questions | Assessment Questions |
|---|---|---|
| Timing | During application | After application, in pipeline |
| Scoring | Not scored | Automatic or manual scoring |
| Purpose | Initial screening | Skills evaluation |
| Required | Optional or required | Triggered by stage |
| Validation | Basic validation | Pass/fail threshold |
Use custom questions for basic screening (“Do you have work authorization?”) and assessments for technical evaluation.
Best Practices
Set reasonable time limits
Set reasonable time limits
Allow enough time for candidates to thoughtfully answer without feeling rushed. 45-90 minutes is typical for technical assessments.
Balance question types
Balance question types
Mix multiple choice (quick, auto-graded) with short answer (deeper evaluation) for comprehensive assessment.
Weight questions appropriately
Weight questions appropriately
Assign higher point values to complex questions that better indicate skill level.
Test your assessments
Test your assessments
Complete your own assessments to check clarity, difficulty, and time requirements.
Review pass score regularly
Review pass score regularly
Adjust thresholds based on candidate performance and hiring success rates.
Provide clear instructions
Provide clear instructions
Use question descriptions to explain expected format, especially for code submissions.
Assessment Management
Updating Assessments
Modify assessment details:- Title and description
- Time limit (applies to new attempts only)
- Pass score threshold
Managing Questions
Add Questions: Build comprehensive tests over time Update Questions: Fix typos, improve clarity, adjust points Delete Questions: Remove outdated or ineffective questionsDeleting Assessments
Removing an assessment will:- Delete all associated questions and options
- Preserve historical attempt records
- Remove from available assessments for new stages
Next Steps
Attach to Pipeline Stages
Configure assessment triggers in your hiring flow
View Candidate Results
Review assessment attempts and scores
Create Email Templates
Design assessment invitation emails
Generate Offers
Move successful candidates to offer stage