Start Resume processing

POST/process-resume

Starts the ResumeStateMachine for a single Resume (document verification, content extraction, parallel detail extraction, and Knowledge Graph fill-out). The handler validates the Authorization header against the Redis token resume_cookie:{resume_id}, loads the Resume row to resolve its Business Unit, locks resume-processing credits, launches the state machine, and sets the Resume processing_status to in_progress.

Authorization

resourceToken

AuthorizationBearer <token>

Per-resource bearer token. The Authorization header value must exactly match the short-lived token the control plane stored in Redis under the resource-scoped key for the id in the request body (job_match_cookie:{id}, resume_cookie:{id}, or import_activity_cookie:{id}). This is an application-level check; there is no API Gateway authorizer.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

resume_id*integer

Identifier of the Resume document to ingest and process. Must be a positive integer.

Response Body

`application/json`

curl -X POST "https://example.com/process-resume" \  -H "Content-Type: application/json" \  -d '{    "resume_id": 567  }'

{  "message": "Processing started for resume_id: 567"}

{  "message": "Invalid resume_id",  "step": "process-resume",  "resume_id": null}

{  "message": "Unauthorized"}

{  "message": "Resume not found",  "resume_id": 0,  "import_activity_id": 0}

{  "message": "Internal server error"}

Start Resume processing

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`