Create hotlist
A new candidate hotlist, optionally linked to a job.
MCP tool jobdiva_write → create_hotlist
write
Returns the hotlist_id for add_candidates_to_hotlist. Linking a job puts the hotlist on that job. It shares the hotlist with nobody, so it does not wait for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| name string required | string | Hotlist name. |
| description string required | string | What the hotlist is for. |
| job_id integer | integer | Job to link the hotlist to. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "jobdiva_write",
"arguments": {
"operation": "create_hotlist",
"arguments": {
"name": "Jane Doe",
"description": "description"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"hotlist_id": 88314,
"name": "Senior Data Analyst - Northwind",
"job_id": 24071835,
"status": "created"
},
"isError": false
}