Update a job monitor
monitor_updatePurpose: Change a saved monitor without losing what it collected or what the user decided; send only what changes, since everything else stays as saved. When: The user wants a different title, location, company, keyword or field on a saved monitor. Cost: About 160 tokens for the saved monitor.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"companies": [
"Contoso"
],
"monitorId": 12
},
"name": "monitor_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | No | Words that must appear in the posting's text. | |
| companies | No | Company names; a posting from any of them is kept, and leaving them out watches the whole market. | |
| locations | No | Real location names, each read as the closest known location; check monitor.locations in the result for what it watches. | |
| monitorId | Yes | The monitor id from monitor_list. | |
| salaryMax | No | Highest yearly salary to keep, in US dollars after the same conversion. | |
| salaryMin | No | Lowest yearly salary to keep, in US dollars after each posting's published salary is converted. | |
| titleText | No | Words of the job title, matched to one of searchnapply's known roles (resolvedRole.display names it), which the monitor then watches. | |
| datePosted | No | How recently the posting was published; leave it out for any date. | |
| department | No | One department slug, to narrow a title that spans departments; call job_postings_search_fields for what each one holds. | |
| experience | No | Experience level to keep, given as exact, since a monitor keeps one level and no lowest level. | |
| includeFamily | No | Also return postings from the resolved role's wider family; leave it out to keep the monitor's current setting. | |
| locationTypes | No | Workplace types to keep. | |
| employmentType | No | Employment type to keep. | |
| salaryCurrency | No | A three-letter currency code that only labels the monitor. | |
| excludeKeywords | No | Words that must not appear in the title or the text, 1 to 10 words. | |
| includeNoSalary | No | Keep postings that publish no salary; true by default. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| monitor | Yes | The monitor as saved. | |
| titleNote | No | Present when no role matched: the title words are matched against posting titles. | |
| resolvedRole | No | The role the title words were read as; absent when no role matched. | |
| unrecognizedLocations | No | The location names that matched no known location and were left out. |