hr
Workable CLI for Headless Automation
Use the Workable CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write Bearer token auth
Workable CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Workable CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Workable CLI for Headless Automation
kosmokrator integrations:configure workable --set access_token="$WORKABLE_ACCESS_TOKEN" --set subdomain="$WORKABLE_SUBDOMAIN" --enable --read allow --write ask --json
kosmo integrations:call workable.workable_list_jobs '{"state":"example_state","limit":1,"offset":1}' --json Discovery Before Execution
Agents and scripts can inspect Workable docs and schemas before choosing a function.
kosmo integrations:docs workable --json
kosmo integrations:docs workable.workable_list_jobs --json
kosmo integrations:schema workable.workable_list_jobs --json
kosmo integrations:search "Workable" --json
kosmo integrations:list --json Useful Workable CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
workable.workable_list_jobs | Read | state, limit, offset | List jobs from your Workable account. Optionally filter by state (published, draft, closed, archived). Returns paginated results with job titles, shortcodes, and statuses. |
workable.workable_get_job | Read | shortcode | Get full details for a specific Workable job by its shortcode. Returns title, description, department, location, employment type, salary, and application counts. |
workable.workable_create_job | Write | title, description, department, employment_type | Create a new job posting in Workable. Specify the title, description, department, and employment type. The job is created in draft state by default. |
workable.workable_list_candidates | Read | shortcode, limit, offset | List candidates for a specific Workable job. Returns paginated results with candidate names, emails, stages, and applied dates. |
workable.workable_get_candidate | Read | id | Get full details for a specific Workable candidate by ID. Returns profile info, resume, cover letter, application stage, and activity history. |
workable.workable_list_members | Read | none | List all team members in your Workable account, including recruiters and hiring managers. Returns names, emails, and roles. |
workable.workable_get_current_user | Read | none | Get the profile of the currently authenticated Workable user. Useful for verifying credentials and identifying who the API is acting as. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.