Talentino Docs
API ReferencePipeline API (internal)

Start Job Match scoring

POST/start-processing

Starts the JobMatchStateMachine for the given Job Match. The handler validates the Authorization header against the Redis token job_match_cookie:{job_match_id}, loads the Job Match row, and — when the Job Match is in draft status — reads the queued job-position payload from Redis key jobMatchData:{job_match_id} to extract job requirements. It then locks the required credits, sends a realtime job_match_started notification, launches the state machine (passing the row's conformity_decision so the workflow can route Scoring across the Business Unit's Resumes), and flips the Job Match status to ongoing.

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.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/start-processing" \  -H "Content-Type: application/json" \  -d '{    "job_match_id": 1234  }'
{  "message": "Processing started for job_match_id: 1234"}
{  "message": "string"}
{  "message": "Unauthorized"}
{  "message": "string"}
{  "message": "Internal server error"}