update_subscription
Modify an existing job alert by ID, changing only the fields you provide—such as search filters, salary range, delivery channels, or paused status—to update alerts without recreating them.
Instructions
Change one of the person's job alerts by its id. Read its current search from list_subscriptions and pass only what changes — every field is optional: name; the search (query, filters, salary_min, salary_max — each replaces that part, an empty filters object clears the facet filters, a salary bound of 0 clears it; website-only filters in other are kept); channels (the full set to deliver on — added ones must be connected, missing ones stop); paused (true stops every channel, false resumes them — prefer it to unsubscribe for holding an alert). The new search must still narrow the catalogue, and unknown values are dropped and named in ignored_params. e.g. remote senior Go roles in the EU paying at least 80k EUR is {"filters":{"work_mode":["remote"],"seniority":["senior"],"skills":["go"],"regions":["eu"],"salary_currency":["EUR"]},"salary_min":80000}. Digest timing is account-wide and not changed here. A removed channel's record of matches is deleted with it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The alert id, from list_subscriptions or subscribe. | |
| name | No | A new name (1-100 characters). | |
| query | No | Free-text query, with the job search's operators. | |
| paused | No | true pauses every channel, false resumes them. | |
| filters | No | Facet filters by param name (skills, seniority, category, work_mode, regions, countries, cities, metros, company_slug, employment_type, salary_currency, source, …), each a list of values. An unknown filter name is refused. | |
| channels | No | The complete set of channels to deliver on. | |
| salary_max | No | Only postings whose stated salary ceiling is at most this. 0 clears it on update. | |
| salary_min | No | Only postings whose stated salary floor is at least this, in the posting's currency — pair it with filters.salary_currency. 0 clears it on update. |