Job interactions

PATCH /jobs/{slug}/track Session or API key

Set the application stage and/or notes.

A null field is left unchanged. stage is a controlled vocabulary: applied, screening, responded, interview, offer, accepted, rejected, withdrawn (an unknown value is a 400).

Path parameters

slug string required
The job public_slug.

Body

stage string
Application stage from the vocabulary above.Example interview
notes string
Free-text notes.
curl
curl -X PATCH "https://freehire.dev/api/v1/jobs/<slug>/track" \
  -H "Authorization: Bearer $FREEHIRE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"stage":"interview","notes":"call on Friday"}'
json — response
{ "data": { "job_id": 42, "stage": "interview", "notes": "call on Friday" } }