list_offices
Fetch all offices to map location names to IDs, enabling job creation, job listing, and future job permission setup.
Instructions
List all offices. Read-only.
Resolves office/location names to IDs. When a user mentions an office
or location, use this to find its ID for list_jobs, create_job, or
add_future_job_permission. Each office has a flat location string,
parent_id, and primary_in_house_contact_user_id.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_offices"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Pass next_cursor from the previous response to get the next page | |
| paginate | No | 'single' for one page, 'all' to auto-fetch every page | single |
| per_page | No | Results per page (max 500) | |
| parent_id | No | Only offices directly under this parent office | |
| force_refresh | No | Bypass cache and fetch fresh data |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |