Skip to Content
CapstoneDocs
Ashby

Assessment update (Ashby)

Sent to https://api.ashbyhq.com/assessment.update with the customer's own Ashby API key when the candidate starts, when results are ready, and when a recruiter cancels inside Capstone. Delivered only when Ashby answers success: true; otherwise retried up to 6 times with exponential backoff from one minute. A run without a numeric score reports the string "Not scored".

Request Body

application/json
  1. body
assessment_id*string
Formatuuid
timestamp*integer

Unix milliseconds

assessment_status?
assessment_result?
assessment_profile_url?
cancelled_reason?
metadata?array<>

Response Body

success: true counts as delivered.

Example Requests
POST/ashbyAssessmentUpdate
Request Body
application/json
{  "assessment_id": "5b7c9e1a-2d3f-4a5b-8c6d-7e8f9a0b1c2d",  "timestamp": 1762598527512,  "assessment_status": {    "identifier": "assessment_status",    "label": "Status",    "type": "string",    "value": "Completed"  },  "assessment_result": {    "identifier": "overall_score",    "label": "Overall score",    "description": "Out of 100",    "type": "numeric_score",    "value": 82  },  "assessment_profile_url": {    "identifier": "report_url",    "label": "Capstone report",    "type": "url",    "value": "https://usecapstone.com/recruiter/simulations/…"  },  "metadata": [    {      "identifier": "authenticity",      "label": "AI-usage assessment",      "type": "string",      "value": "Authentic"    },    {      "identifier": "certificate_url",      "label": "Certificate",      "type": "url",      "value": "https://usecapstone.com/verify/CAP-2026-0811"    }  ]}