Set job visibility

Make an active job public, private or closed.

PUT https://cotlet.dev/api/v1/homerun/jobs/{job_id}/visibility

write Confirm

Works on active jobs; a draft or archived job returns an error. Closed stops new applications and keeps the hiring process going; anyone with the link sees "Applications closed". Public shows the job to everyone, private only to people with the share link. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: set_job_visibility
NameTypeDescription
job_id string required string Job ID from list_jobs.
visibility string required string public, private or closed.

Request

cURL
curl -X PUT https://cotlet.dev/api/v1/homerun/jobs/job_9d4a27/visibility \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"visibility":"closed"}'
Python
result = client.call("homerun", "set_job_visibility", {"job_id":"job_9d4a27","visibility":"closed"})
Node.js
const result = await cotlet.call('homerun', 'set_job_visibility', {"job_id":"job_9d4a27","visibility":"closed"});
CLI
cotlet call homerun set_job_visibility --data '{"job_id":"job_9d4a27","visibility":"closed"}'

Example response

JSON

{
  "job_id": "job_9d4a27",
  "title": "Product Designer",
  "state": "active",
  "visibility": "closed"
}

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.