Update a job | CONFIRM Docs

curl -X PATCH https://api.confirm.global/partner/v1/organizations/org_4Nv8sJqKfH/jobs/job_2VbY6mQwXs \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "id": "job_2VbY6mQwXs",
  "org_id": "org_4Nv8sJqKfH",
  "template_id": "tpl_fl_caregiver_registry",
  "title": "In-Home Caregiver (CNA/HHA) — Tampa",
  "location": {
    "city": "Tampa",
    "state": "FL",
    "zip": "33602"
  },
  "pay_range": {
    "min": 17,
    "max": 21,
    "currency": "USD",
    "period": "hour"
  },
  "status": "active",
  "screening_questions": [
    {
      "position": 1,
      "question": "Do you have an active Florida CNA or HHA license?",
      "knockout": true
    }
  ],
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z"
}

Updates a job’s title, location, pay range, or status. Screening questions are template-managed and read-only through the Partner API. Omitted fields are unchanged.

Authentication

AuthorizationBearer

Partner API key sent as Authorization: Bearer cfk_.... Keys are partner-level — one key reaches every registry linked to your partner account and nothing else. CONFIRM issues and revokes them; a key is shown exactly once at creation because only its hash is stored, and revocation takes effect on the next request. Develop against the sandbox base URL with a sandbox key, where telephony is restricted to an allowlist you provide.

Partner API key sent as `Authorization: Bearer cfk_...`. Keys are partner-level — one key reaches every registry linked to your partner account and nothing else. CONFIRM issues and revokes them; a key is shown exactly once at creation because only its hash is stored, and revocation takes effect on the next request. Develop against the sandbox base URL with a sandbox key, where telephony is restricted to an allowlist you provide.

Path parameters

org_idstringRequired

Organization ID (org_...).

job_idstringRequired

Job ID (job_...).

Request

This endpoint expects an object.

titlestringOptional

locationobjectOptional

City/state/ZIP location.

pay_rangeobjectOptional

Pay range advertised for the job.

statusenumOptional

Allowed values:

Response

The updated job.

idstringOptional

Job ID (job_...).

org_idstringOptional

template_idstringOptional

Template the job was created from.

titlestringOptional

locationobjectOptional

City/state/ZIP location.

pay_rangeobjectOptional

Pay range advertised for the job.

statusenumOptional

screening_questionslist of objectsOptional

Read-only summary of the questions asked on screenings for this job, including knockout flags.

created_atdatetimeOptional

updated_atdatetimeOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error