Skillflare

Core concepts

Candidates, challenges, sessions, evaluation sets, API keys, and webhooks

These building blocks appear in the dashboard. Challenges, candidates, sessions, and organizations map 1:1 to API resources. Evaluation sets are nested on session detail. Webhooks and Api keys are dashboard-only.

ConceptMeaning
ChallengeA published assessment: compute tier, tools, duration, rubric, brief, desktop files, and truth pack.
SessionOne candidate attempt at a challenge — status, recording, and scores. An optional expires_at closes the lobby link after that time; a session still PENDING then becomes EXPIRED. After the candidate clicks "I am ready", they have 30 minutes to start recording or the session becomes DROPPED_OUT.
CandidateA person linked to your organization (email and optional name).
OrganizationThe account that owns candidates, challenges, sessions, and API keys.
Evaluation setOne scoring run of a session: several independent evaluations plus aggregated scores.
API keyAn organization credential (sk_skillflare_...) sent as x-api-key.
WebhookAn HTTPS endpoint that receives POSTs when session or evaluation-set events occur.

Typical flow

  1. Create a challenge from a job description.
  2. Create or link a candidate with an email address.
  3. Create a session against a READY challenge. Set expires_at when the lobby link should stop working.
  4. Candidate clicks "I am ready" via their invite link. Recording must start within 30 minutes, or the session becomes DROPPED_OUT and is not evaluated.
  5. Fetch the session until session_status is COMPLETED, FAILED, DROPPED_OUT, or EXPIRED.

Introduction

What Skillflare is and how assessments work

Webhooks

Outbound notifications for session and evaluation-set events

On this page

Typical flow