PATCH /jobs/{id} — Partially Update or Close a Job

Update any field on an existing job posting, or change its status to pause or close it. Partial updates are supported — only include the fields you want to change.

Endpoint

PATCH https://api.cutshort.io/v1/jobs/{id}

Path Parameters

string

required

The unique Cutshort job ID of the posting you want to update (e.g., job_4xRt2wPv).

Request Body

All fields are optional. Include only the fields you want to update.

string

Updated job title. Maximum 150 characters.

string

Updated job description. Markdown is supported.

array

Revised list of required technical skills.

array

Revised list of preferred (nice-to-have) skills.

integer

Updated minimum years of experience required.

integer

Updated maximum years of experience.

string

Updated city name or Remote.

string

Updated work arrangement. One of onsite, remote, or hybrid.

integer

Updated minimum salary in INR (annual).

integer

Updated maximum salary in INR (annual).

string

Updated job status. One of active, paused, or closed.

Example: Close a Job

curl -X PATCH 'https://api.cutshort.io/v1/jobs/job_4xRt2wPv' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"status": "closed"}'

import requests

response = requests.patch(
    "https://api.cutshort.io/v1/jobs/job_4xRt2wPv",
    json={"status": "closed"},
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

Example: Update Salary Range

curl -X PATCH 'https://api.cutshort.io/v1/jobs/job_4xRt2wPv' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"salary_min": 2500000, "salary_max": 4000000}'

import requests

response = requests.patch(
    "https://api.cutshort.io/v1/jobs/job_4xRt2wPv",
    json={"salary_min": 2500000, "salary_max": 4000000},
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

Response

Returns 200 OK with the full updated job object reflecting your changes.

{
  "id": "job_4xRt2wPv",
  "title": "Senior Backend Engineer",
  "status": "closed",
  "location": "Bengaluru",
  "remote_type": "hybrid",
  "skills_required": ["Python", "Django", "PostgreSQL"],
  "skills_preferred": ["Redis", "Celery"],
  "experience_min": 4,
  "experience_max": 8,
  "salary_min": 2500000,
  "salary_max": 4000000,
  "shortlist_count": 23,
  "created_at": "2024-01-10T09:00:00Z"
}

Partial updates only — omit any field you do not want to change; PATCH will not overwrite it.Status transitions: active ↔ paused are reversible. Setting status: closed is permanent — a closed job cannot be reopened via the API. Closing a job immediately stops all sourcing activity. Candidates already in the pipeline are not affected.

Overview

Candidates

Jobs

Sourcing

Webhooks

PATCH /jobs/{id} — Partially Update or Close a Job

Endpoint

Path Parameters

Request Body

Example: Close a Job

Example: Update Salary Range

Response

​Endpoint

​Path Parameters

​Request Body

​Example: Close a Job

​Example: Update Salary Range

​Response

Endpoint

Path Parameters

Request Body

Example: Close a Job

Example: Update Salary Range

Response