BACK_TO_CORE_DASHBOARD
DevHire
/

API_SPEC

Industrial-grade automation protocols for technical assessment infrastructure. Version 1.0.4-BETA.

STATUS:
OPERATIONAL

[00] Overview

The DevHire API architecture is built for deterministic evaluation of technical talent. Connect your ATS, CI/CD pipelines, or custom HRIS directly to our sandboxed Linux kernels.

Isolated Execution

Assessments run in hardened Firecracker microVMs. Full system-level isolation with zero persistent data leakage.

Real-Time Telemetry

Stream grading data, keystroke rhythm, and resource usage metrics via high-availability webhooks.

[01] Authentication

All API requests must include a secret key in the Authorization header. Use your production secret for live requests and the test secret for local debugging.

AuthSPEC_v1
GET /v1/organizations/me HTTP/1.1
Host: api.devhire.systems
Authorization: Bearer <sk_prod_...>

[02] Invite_Candidate

Trigger an automated assessment invitation. This creates a secure, time-limited workspace and dispatches access credentials to the candidate.

POST/api/invite

Parameters

namestringLegal name of the candidate.
emailstringTarget for invitation dispatch.
stackstringDefined sandbox profile (e.g. 'nextjs_v14').
JSON Payload
{
  "name": "Alex Rivera",
  "email": "alex@github.com",
  "stack": "rust_bare_metal",
  "difficulty": "enterprise"
}

[03] Grading_Signal

Listen for high-integrity signals emitted from assessment sandboxes. Verify the payload using the X-DevHire-Signature header.

WEBHOOK/api/webhooks/grading
{
  "id": "evt_0x98213",
  "type": "assessment.completed",
  "data": {
    "score": 98,
    "grade": "S+",
    "verified": true,
    "metrics": {
      "execution_time": "12.4s",
      "purity_score": 0.99
    }
  }
}