Skip to main content
PATCH
/
v1
/
saved-searches
/
{id}
Update Saved Search
curl --request PATCH \
  --url https://api.example.com/v1/saved-searches/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "query": {},
  "metadata": {}
}
'

​
Overview

Updates a saved search. All body fields are optional — only the fields you supply are changed. Metadata uses merge semantics: passing {"key": null} removes that key, and other keys are merged into the existing metadata. Requires the portfolios:manage scope.

​
Path Parameters

​
id
string
required
Saved search UUID.

​
Request Body

​
name
string
New name (1-255 characters).
​
description
string
New description (max 2000 characters). Pass null to clear.
​
query
object
Replacement stored query (same shape as POST /v1/trademarks/search).
​
metadata
object
Metadata patch. Values may be strings (set/update) or null (remove).

​
Response

Returns the updated saved search. Same shape as Get Saved Search.

​
Code Examples

curl -X PATCH "https://api.signa.so/v1/saved-searches/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Nike clearance watch (Q2)",
    "metadata": { "priority": "high", "owner": null }
  }'

​
Errors

StatusTypeDescription
400validation_errorEmpty name, invalid metadata, or bad UUID
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks portfolios:manage
404not_foundSaved search does not exist or belongs to another org
409conflictAnother saved search already uses this name