---
title: "Changes to Update Saved Search"
method: PATCH
path: "/v0/saved_searches/{search_id}"
---

# Changes to Update Saved Search

`PATCH /v0/saved_searches/{search_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 96 revisions.

- **2026-10-22** `4f3da5ce4026`: 1 info
- **2026-10-14** `acc7d199f39a`: 20 info
- **2026-10-13** `7271dd1852ce`: 1 warning
- **2026-09-09** `8ede3e49dfc8`: 8 info
- **2026-08-18** `b50cf2b28adb`: 1 info
- **2026-08-12** `9fbd24075228`: 8 info
- **2026-07-31** `085f0682e12a`: 2 info
- **2026-07-26** `42f4f2e2c74a`: 10 info
- **2026-07-13** `641fc0ca14d0`: 1 breaking, 1 warning, 33 info
- **2026-05-10** `1dae359ce2c7`: 2 breaking, 29 info
- **2026-01-14** `ecd1eb029865`: 1 info

## Changes

- **2026-10-22** `4f3da5ce4026`: 1 info
  - added the optional property `origin` to the response with the `200` status
- **2026-10-14** `acc7d199f39a`: 20 info
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/company_not_revealed_at_gte`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/company_not_revealed_at_lte`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/company_not_revealed_within_hours`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/company_revealed_within_hours`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/company_not_revealed_at_gte`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/company_not_revealed_at_lte`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/company_not_revealed_within_hours`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/company_revealed_within_hours`
  - request property `body/anyOf[subschema #1: CompanySearchFilters]/revealed_company_data` reactivated
  - request property `body/anyOf[subschema #2: JobSearchFilters]/revealed_company_data` reactivated
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/company_not_revealed_at_gte` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/company_not_revealed_at_lte` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/company_not_revealed_within_hours` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/company_revealed_within_hours` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #2: JobSearchFilters]/company_not_revealed_at_gte` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #2: JobSearchFilters]/company_not_revealed_at_lte` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #2: JobSearchFilters]/company_not_revealed_within_hours` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #2: JobSearchFilters]/company_revealed_within_hours` to the response with the `200` status
  - response property `body/anyOf[subschema #1: CompanySearchFilters]/revealed_company_data` reactivated
  - response property `body/anyOf[subschema #2: JobSearchFilters]/revealed_company_data` reactivated
- **2026-10-13** `7271dd1852ce`: 1 warning
  - removed the request property `emails_subscribed`
- **2026-09-09** `8ede3e49dfc8`: 8 info
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/company_revealed_at_gte`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/company_revealed_at_lte`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/company_revealed_at_gte`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/company_revealed_at_lte`
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/company_revealed_at_gte` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/company_revealed_at_lte` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #2: JobSearchFilters]/company_revealed_at_gte` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #2: JobSearchFilters]/company_revealed_at_lte` to the response with the `200` status
- **2026-08-18** `b50cf2b28adb`: 1 info
  - added the optional property `creator/picture_url` to the response with the `200` status
- **2026-08-12** `9fbd24075228`: 8 info
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/workplace_types_or`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/workplace_types_or`
  - request property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/remote` deprecated
  - request property `body/anyOf[subschema #2: JobSearchFilters]/remote` deprecated
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/workplace_types_or` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #2: JobSearchFilters]/workplace_types_or` to the response with the `200` status
  - response property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/remote` deprecated
  - response property `body/anyOf[subschema #2: JobSearchFilters]/remote` deprecated
- **2026-07-31** `085f0682e12a`: 2 info
  - the `order_by` request property default value `{"desc":true,"field":"relevance"}` was removed
  - the `order_by` response's property default value `{"desc":true,"field":"relevance"}` was removed for the status `200`
- **2026-07-26** `42f4f2e2c74a`: 10 info
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/company_country_code_not_or_null`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/industry_id_not_or_null`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/min_num_jobs_found`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/company_country_code_not_or_null`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/industry_id_not_or_null`
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/company_country_code_not_or_null` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/industry_id_not_or_null` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/min_num_jobs_found` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #2: JobSearchFilters]/company_country_code_not_or_null` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #2: JobSearchFilters]/industry_id_not_or_null` to the response with the `200` status
- **2026-07-13** `641fc0ca14d0`: 1 breaking, 1 warning, 33 info
  - removed `#/components/schemas/JobFilters` from the `body/anyOf[subschema #1: CompanySearchFilters]/job_filters` request property `anyOf` list
  - added the new `relevance` enum value to the `body/anyOf[subschema #1: CompanySearchFilters]/order_by/items/field` response property for the response status `200`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/company_id_not`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/closed_at_gte`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/closed_at_lte`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/company_id_not`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/is_closed`
  - added the new optional request property `body/anyOf[subschema #2: JobSearchFilters]/job_export_key_or`
  - added `#/components/schemas/JobFilters-Input` to the `body/anyOf[subschema #1: CompanySearchFilters]/job_filters` request property `anyOf` list
  - the `order_by` request property default value changed from `{"desc":true,"field":"confidence"}, {"desc":true,"field":"num_jobs_found"}, {"desc":true,"field":"num_jobs"}, {"desc":true,"field":"num_jobs"}, {"desc":true,"field":"employee_count"}` to `{"desc":true,"field":"relevance"}`
  - request property `body/anyOf[subschema #2: JobSearchFilters]/job_location_pattern_not` deprecated
  - request property `body/anyOf[subschema #2: JobSearchFilters]/job_location_pattern_or` deprecated
  - added the new `relevance` enum value to the request property `body/anyOf[subschema #1: CompanySearchFilters]/order_by/items/field`
  - request property `body/anyOf[subschema #1: CompanySearchFilters]/company_technology_slug_and` reactivated
  - request property `body/anyOf[subschema #1: CompanySearchFilters]/company_technology_slug_not` reactivated
  - request property `body/anyOf[subschema #1: CompanySearchFilters]/company_technology_slug_or` reactivated
  - request property `body/anyOf[subschema #2: JobSearchFilters]/company_technology_slug_and` reactivated
  - request property `body/anyOf[subschema #2: JobSearchFilters]/company_technology_slug_not` reactivated
  - request property `body/anyOf[subschema #2: JobSearchFilters]/company_technology_slug_or` reactivated
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/company_id_not` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #2: JobSearchFilters]/closed_at_gte` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #2: JobSearchFilters]/closed_at_lte` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #2: JobSearchFilters]/company_id_not` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #2: JobSearchFilters]/is_closed` to the response with the `200` status
  - added `#/components/schemas/JobFilters-Output` to the `body/anyOf[subschema #1: CompanySearchFilters]/job_filters` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/JobFilters` from the `body/anyOf[subschema #1: CompanySearchFilters]/job_filters` response property `anyOf` list for the response status `200`
  - the `order_by` response's property default value changed from `{"desc":true,"field":"confidence"}, {"desc":true,"field":"num_jobs_found"}, {"desc":true,"field":"num_jobs"}, {"desc":true,"field":"num_jobs"}, {"desc":true,"field":"employee_count"}` to `{"desc":true,"field":"relevance"}` for the status `200`
  - response property `body/anyOf[subschema #2: JobSearchFilters]/job_location_pattern_not` deprecated
  - response property `body/anyOf[subschema #2: JobSearchFilters]/job_location_pattern_or` deprecated
  - response property `body/anyOf[subschema #1: CompanySearchFilters]/company_technology_slug_and` reactivated
  - response property `body/anyOf[subschema #1: CompanySearchFilters]/company_technology_slug_not` reactivated
  - response property `body/anyOf[subschema #1: CompanySearchFilters]/company_technology_slug_or` reactivated
  - response property `body/anyOf[subschema #2: JobSearchFilters]/company_technology_slug_and` reactivated
  - response property `body/anyOf[subschema #2: JobSearchFilters]/company_technology_slug_not` reactivated
  - response property `body/anyOf[subschema #2: JobSearchFilters]/company_technology_slug_or` reactivated
- **2026-05-10** `1dae359ce2c7`: 2 breaking, 29 info
  - removed `#/components/schemas/JobSearchFilters` from the `body` request property `anyOf` list
  - removed `#/components/schemas/TechnographicsTechnologyFilters` from the `body/anyOf[subschema #1: CompanySearchFilters]/tech_filters` request property `anyOf` list
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/company_keyword_slug_and`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/company_keyword_slug_not`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/company_keyword_slug_or`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/cursor`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/job_description_pattern_and`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/job_keyword_slug_and`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/job_keyword_slug_not`
  - added the new optional request property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/job_keyword_slug_or`
  - added `#/components/schemas/JobSearchFilters-Input` to the `body` request property `anyOf` list
  - added `#/components/schemas/KeywordFilters` to the `body/anyOf[subschema #1: CompanySearchFilters]/tech_filters` request property `anyOf` list
  - request property `body/anyOf[subschema #1: CompanySearchFilters]/company_technology_slug_and` deprecated
  - request property `body/anyOf[subschema #1: CompanySearchFilters]/company_technology_slug_not` deprecated
  - request property `body/anyOf[subschema #1: CompanySearchFilters]/company_technology_slug_or` deprecated
  - request property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/job_description_pattern_case_sensitive_or` deprecated
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/company_keyword_slug_and` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/company_keyword_slug_not` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/company_keyword_slug_or` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/job_description_pattern_and` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/job_keyword_slug_and` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/job_keyword_slug_not` to the response with the `200` status
  - added the optional property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/job_keyword_slug_or` to the response with the `200` status
  - added `#/components/schemas/JobSearchFilters-Output` to the `body` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/KeywordFilters` to the `body/anyOf[subschema #1: CompanySearchFilters]/tech_filters` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/JobSearchFilters` from the `body` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/TechnographicsTechnologyFilters` from the `body/anyOf[subschema #1: CompanySearchFilters]/tech_filters` response property `anyOf` list for the response status `200`
  - response property `body/anyOf[subschema #1: CompanySearchFilters]/company_technology_slug_and` deprecated
  - response property `body/anyOf[subschema #1: CompanySearchFilters]/company_technology_slug_not` deprecated
  - response property `body/anyOf[subschema #1: CompanySearchFilters]/company_technology_slug_or` deprecated
  - response property `body/anyOf[subschema #1: CompanySearchFilters]/job_filters/anyOf[subschema #1: JobFilters]/job_description_pattern_case_sensitive_or` deprecated
- **2026-01-14** `ecd1eb029865`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/theirstack/apis/theirstack-api-reference/docs/v0/saved_searches/:search_id/patch.md) - [API](https://skmtc.dev/theirstack/apis/theirstack-api-reference.md) - [Page](https://skmtc.dev/theirstack/apis/theirstack-api-reference/changes/v0/saved_searches/:search_id/patch)
