archive_reason_list
Retrieve available archive reasons to properly move candidate applications to the Archived stage in the hiring pipeline.
Instructions
List all archive reasons (needed for application_change_stage to Archived).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/ashby/server.py:407-434 (handler)The `handle_call_tool` function serves as the central handler for all registered MCP tools. It uses the `TOOL_ENDPOINT_MAP` to map the tool name "archive_reason_list" to the Ashby API endpoint "/archiveReason.list" and executes the request via the `AshbyClient`.
@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:356-362 (schema)Tool definition for "archive_reason_list" including its description and empty input schema.
name="archive_reason_list", description="List all archive reasons (needed for application_change_stage to Archived).", inputSchema={ "type": "object", "properties": {}, }, ), - src/ashby/server.py:397-397 (registration)Registration mapping from the tool name "archive_reason_list" to the API endpoint path.
"archive_reason_list": "/archiveReason.list",