API Reference

PATCH Update Job

v1Updated 2026-03-07

Update job

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

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

Body field	Type	Required
name	string	no
status	string	no
location_id	integer	no
recruiter_id	integer	no

Request


curl -X PATCH \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Idempotency-Key: jobs-update-102" \
  -H "Content-Type: application/json" \
  -d '{"status":"closed"}' \
  "http://localhost:3333/api/v1/public/agado-ats/jobs/102"

200 Response


{ "data": { "id": 102, "name": "Senior Backend Engineer", "status": "closed" } }

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"
  }
}