API Reference

PATCH Update Candidate

v1Updated 2026-03-07

Update candidate

PATCH/api/v1/public/:tenant_slug/candidates/:id

Header	Required	Description
Authorization	yes	`Bearer <API_KEY>`
Idempotency-Key	recommended	Safe retry key.

Body field	Type	Required
full_name	string	no
headline	string	no
company	string	no
location_id	integer	no
recruiter_id	integer	no
candidate_source_id	integer	no

Request


curl -X PATCH \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Idempotency-Key: cand-update-504" \
  -H "Content-Type: application/json" \
  -d '{"headline":"Senior QA Engineer"}' \
  "http://localhost:3333/api/v1/public/agado-ats/candidates/504"

200 Response


{ "data": { "id": 504, "full_name": "Ana Novak", "headline": "Senior QA Engineer" } }

400 Response


{
  "error": {
    "code": "bad_request",
    "message": "Validation failed for request payload",
    "request_id": "req_123"
  }
}

500 Response


{
  "error": {
    "code": "internal_error",
    "message": "Unexpected server error",
    "request_id": "req_500"
  }
}