Human resources · list_candidates
List candidates
Candidates for a role with score and stage.
- Price
- included
- Requirements
- No connector
- runs on platform keys
- Human approval
- No
- read or internal write
Input
| Field | Type | Description |
|---|---|---|
| position | string | Position / job title (partial, case-insensitive) |
| status | array | Statuses to include (default: new, screening, interview, offer) |
| query | string | Partial name or email |
| minScore | number | Only candidates with fitScore >= this value |
| limit | number | Max rows (1-200, default 50) |
Call this tool
Through the HTTP API, or from the MCP server with the run meta-tool.
curl https://api.ezyagents.fr/gateway/v1/run \
-H "Authorization: Bearer ezk_…" -H "Content-Type: application/json" \
-d '{"tool":"list_candidates","input":{"position":"…","status":[],"query":"…","minScore":1}}'$
run({ "tool": "list_candidates", "input": {"position":"…","status":[],"query":"…","minScore":1} })