Search Jobs Tool
search-jobsSearches the authenticated workspace jobs using safe summary fields only; it does not return service addresses, notes, or amounts. Use to search jobs in the connected business. Returns query, count, jobs, scope.
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": "search-jobs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of jobs to return. | |
| query | No | Customer name, email, phone, or job title. | |
| status | No | Optional job status filter. | |
| customer_id | No | Restrict results to one customer ID. | |
| location_id | No | Restrict results to one business location ID. | |
| scheduled_to | No | Inclusive scheduled date, YYYY-MM-DD. | |
| scheduled_from | No | Inclusive scheduled date, YYYY-MM-DD. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobs | Yes | Bounded jobs records returned by this tool. | |
| count | Yes | Count for the returned result. | |
| query | Yes | Query used or returned by this tool. | |
| scope | Yes | Authorization scope of this result; data remains restricted to the connected business. |