Scout SelectDeveloper Documentation
Online Interview Recorder

Create Assessment

Define the skills and concepts an online interview recording should cover.

Requires MANAGE_LIVE_INTERVIEW. Creates a "manual" assessment - skills and concepts only, no question bank, since a human interviewer asks free-form questions rather than a fixed set generated by Scout Select.

mutation CreateManualAssessment($input: DeveloperCreateManualAssessmentInput!) {
  developerCreateManualAssessment(input: $input) {
    assessmentId
  }
}
Variables
{
  "input": {
    "jobTitle": "Senior Backend Engineer",
    "companyName": "Acme Corp",
    "rawJobDescription": "We're looking for a senior backend engineer with deep Postgres and distributed systems experience...",
    "skills": [
      { "name": "Postgres", "concepts": ["Indexing", "Query planning", "Replication"] },
      { "name": "Distributed Systems", "concepts": ["Consistency models", "Failure handling"] }
    ]
  }
}
  • skills requires at least one entry. Each skill's concepts array can be empty, but naming the concepts you care about is what lets the report tell you which ones were actually covered.
  • The returned assessmentId is what you pass to Schedule - it behaves like any other assessment for organisation-scoping purposes, but can't be used with Assign (that's for AI-generated assessments only).