List jobs
Jobs of your workspace with client company, visibility and candidate count.
GET https://cotlet.dev/api/v1/recruiterflow/jobs
read
Lists the jobs your user can see, newest first, one page at a time; pass next_cursor back as cursor. status open is the default, closed returns closed jobs. visibility is one of external, internal, unlisted, confidential, draft, closed or closed confidential. query matches part of the job title or the client company. Use job_id in the other tools.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | open (default) or closed. |
| visibility enum | enum | external, internal, unlisted, confidential, draft, closed or closed confidential. |
| query string | string | Part of the job title or the client company name. |
| limit integer | integer | 1 to 50. Default: 25. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/recruiterflow/jobs \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("recruiterflow", "list_jobs")const result = await cotlet.call('recruiterflow', 'list_jobs');cotlet call recruiterflow list_jobsExample response
{
"jobs": [
{
"job_id": "48213",
"title": "Senior Backend Engineer",
"company": "Northwind Labs",
"status": "open",
"visibility": "external",
"location": "Berlin",
"candidates": 14,
"url": "https://recruiterflow.com/jobs/48213"
},
{
"job_id": "48307",
"title": "Product Designer",
"company": "Brightline",
"status": "open",
"visibility": "internal",
"location": "Remote",
"candidates": 9,
"url": "https://recruiterflow.com/jobs/48307"
}
],
"next_cursor": null
}