Update a saved search

Mutable: label, query_text, filters_json, active (snooze toggle). If notifications is present in the body, it REPLACES the entire notification set (delete existing, insert new). To keep an existing notification unchanged, echo it back in the array.

patch/api/v1/users/saved-searches/{saved_search_id}

Request

Base URL: https://api.juju.com
URL: https://api.juju.com/api/v1/users/saved-searches/{saved_search_id}
Auth: none declared

Path parameters

saved_search_idinteger required

Request body

labelstring nullable

query_textstring nullable

filters_jsonobject nullable

activeboolean

notificationsobject[]

Full replacement set — each item is a notification-preference row {channel, enabled, throttle_minutes, ...}. Shape validated at the controller layer; kept as a free object here so the FE can evolve the preference model without a spec change.

Response

Updated saved-search.

dataunknown required

metaobject required

Pagination and context metadata. Always present, empty object ({}) when no metadata applies to the response.

errorsstring[] required

Empty array on success. On failure, human-readable error strings suitable for surfacing to end users.

Example response

{
  "errors": []
}

Changes

No recorded changes to this operation across all 1 revision of this API.