List hotlists

The candidate hotlists you can see.

GET https://cotlet.dev/api/v1/jobdiva/hotlists

read

Returns each hotlist with its id, name, description and the job it is linked to. Check it before create_hotlist, so the agent reuses a hotlist that exists.

Parameters

No parameters.

Request

cURL
curl https://cotlet.dev/api/v1/jobdiva/hotlists \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("jobdiva", "list_hotlists")
Node.js
const result = await cotlet.call('jobdiva', 'list_hotlists');
CLI
cotlet call jobdiva list_hotlists

Example response

JSON

{
  "hotlists": [
    {
      "hotlist_id": 88102,
      "name": "Austin pipeline",
      "description": "Data engineers near Austin",
      "job_id": null
    },
    {
      "hotlist_id": 88314,
      "name": "Senior Data Analyst - Northwind",
      "description": "Matches for job 26-04817",
      "job_id": 24071835
    }
  ]
}

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.