Praxicraft Assess API for Technical Hiring

An assessment is a timed (or untimed) test: tasks, a passing score, and optional proctoring.

If you are recruiting / ops

Create the assessment

In the dashboard, create a new assessment. Give it a clear title hiring managers will recognise.

Add tasks

Attach platform tasks and/or your org’s custom tasks. Order them the way candidates should see them.

Set rules

Time limit, passing score (default 70%), and proctoring options. See Proctoring.

Set status to Active

Drafts cannot receive invites. Activate when you are ready to send candidates.

Invite

Continue on Invitations (UI or API).

Archive assessments you no longer use instead of deleting them (there is no Public API delete).

For engineers

Path ids accept slug or UUID — never the human title alone.

Lifecycle

Status	Meaning
`draft`	Editable; cannot invite
`active`	Accepts invitations
`archived`	Hidden from default lists

Endpoints

Method	Path	Scope
GET	`/assessments/`	`assessments:read`
POST	`/assessments/create/`	`assessments:write`
GET	`/assessments/{slug}/`	`assessments:read`
PATCH	`/assessments/{slug}/update/`	`assessments:write`
POST	`/assessments/{slug}/duplicate/`	`assessments:write`
GET	`/assessments/{slug}/cases/`	`assessments:read`
POST	`/assessments/{slug}/cases/attach/`	`assessments:write`
PUT	`/assessments/{slug}/cases/replace/`	`assessments:write`
DELETE	`/assessments/{slug}/cases/remove/`	`assessments:write` → `204`

List query: status (active | draft | archived | all), search, team_slug / team_id, cursor, page_size.

Create → attach → activate

curl -sS -X POST https://assess.praxicraft.com/api/v1/public/assessments/create/ \
  -H "Authorization: Bearer $PRAXICRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Senior backend screen",
    "time_limit_minutes": 90,
    "passing_score": 70
  }'

Always starts as draft. Then attach tasks (source: platform or org):

curl -sS -X POST \
  "https://assess.praxicraft.com/api/v1/public/assessments/senior-backend-screen/cases/attach/" \
  -H "Authorization: Bearer $PRAXICRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "cases": [{ "case_id": "CASE_UUID", "source": "platform" }] }'

After candidates have started, the lineup locks → 409 TASKS_LOCKED. Activate:

curl -sS -X PATCH \
  "https://assess.praxicraft.com/api/v1/public/assessments/senior-backend-screen/update/" \
  -H "Authorization: Bearer $PRAXICRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "active" }'

Send only fields you mean to change on PATCH. Duplicate: POST /assessments/{slug}/duplicate/ → new draft (201). Candidates/results are not copied. SDK helpers: SDKs.

Invitations

Send candidate links.

Custom tasks

Build your own question library.

Get started

Assessments & candidates

Interviews & webhooks

Content & pipelines

Account & reference

Assessments

If you are recruiting / ops

For engineers

Lifecycle

Endpoints

Create → attach → activate

Next

Invitations

Custom tasks

​If you are recruiting / ops

​For engineers

​Lifecycle

​Endpoints

​Create → attach → activate

​Next

Invitations

Custom tasks

If you are recruiting / ops

For engineers

Lifecycle

Endpoints

Create → attach → activate

Next