Close job

Close an open job and take it off every connected job board.

POST https://cotlet.dev/api/v1/recruiterflow/jobs/{job_id}/close

write Confirm

Closes one job, as Close Job in the job menu does. Recruiterflow closes it at once and pulls it from every connected job board and the careers page. Candidates stay in their stages and nothing is archived or deleted. Reopen it in Recruiterflow with Reopen Job in the same menu, which publishes it to the boards again. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: close_job
NameTypeDescription
job_id string required string Open job id from list_jobs.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/recruiterflow/jobs/job_8c41d2/close \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("recruiterflow", "close_job", {"job_id":"job_8c41d2"})
Node.js
const result = await cotlet.call('recruiterflow', 'close_job', {"job_id":"job_8c41d2"});
CLI
cotlet call recruiterflow close_job --data '{"job_id":"job_8c41d2"}'

Example response

JSON

{
  "job_id": "48213",
  "title": "Senior Backend Engineer",
  "status": "closed",
  "closed_at": "2026-10-23T09:20:00Z",
  "candidates_unchanged": 14
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.