candidate_list_notes
Retrieve all notes for a specific candidate in the Ashby hiring pipeline to track application history and interview feedback.
Instructions
List all notes for a candidate.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| candidateId | Yes | The candidate ID | |
| limit | No | Max results per page | |
| cursor | No | Cursor for next page |
Implementation Reference
- src/ashby/server.py:407-434 (handler)The handle_call_tool function is the handler that executes all tools defined in the server, including candidate_list_notes, by routing to the appropriate Ashby API endpoint using the TOOL_ENDPOINT_MAP.
@server.call_tool() async def handle_call_tool(name: str, arguments: dict[str, Any]) -> list[types.TextContent]: """Route tool calls to the correct Ashby endpoint, passing arguments directly.""" endpoint = TOOL_ENDPOINT_MAP.get(name) if not endpoint: return [types.TextContent(type="text", text=f"Unknown tool: {name}")] try: # Pass arguments straight through -- tool schemas already use Ashby's # camelCase param names so no translation is needed. response = ashby.post(endpoint, data=arguments if arguments else None) return [types.TextContent(type="text", text=json.dumps(response, indent=2))] except requests.exceptions.HTTPError as e: error_body = "" if e.response is not None: try: error_body = e.response.text except Exception: pass return [ types.TextContent( type="text", text=f"Ashby API error on {endpoint}: {e}\n{error_body}", ) ] except Exception as e: return [types.TextContent(type="text", text=f"Error calling {endpoint}: {e}")] - src/ashby/server.py:177-189 (schema)The candidate_list_notes tool is defined and registered in the TOOLS list, including its input schema.
types.Tool( name="candidate_list_notes", description="List all notes for a candidate.", inputSchema={ "type": "object", "properties": { "candidateId": {"type": "string", "description": "The candidate ID"}, "limit": {"type": "integer", "description": "Max results per page"}, "cursor": {"type": "string", "description": "Cursor for next page"}, }, "required": ["candidateId"], }, ), - src/ashby/server.py:374-399 (helper)The TOOL_ENDPOINT_MAP maps the candidate_list_notes tool name to the actual API endpoint '/candidate.listNotes'.
TOOL_ENDPOINT_MAP = { "job_list": "/job.list", "job_info": "/job.info", "job_search": "/job.search", "candidate_list": "/candidate.list", "candidate_search": "/candidate.search", "candidate_info": "/candidate.info", "candidate_create": "/candidate.create", "candidate_create_note": "/candidate.createNote", "candidate_list_notes": "/candidate.listNotes", "candidate_add_tag": "/candidate.addTag", "candidate_tag_list": "/candidateTag.list", "application_list": "/application.list", "application_info": "/application.info", "application_create": "/application.create", "application_change_stage": "/application.change_stage", "interview_stage_list": "/interviewStage.list", "interview_plan_list": "/interviewPlan.list", "interview_list": "/interview.list", "interview_info": "/interview.info", "department_list": "/department.list", "user_list": "/user.list", "source_list": "/source.list", "archive_reason_list": "/archiveReason.list", "location_list": "/location.list", }