---
title: "Update Saved Search"
method: PUT
path: "/api/v1/user/searches/{searchId}/"
tags: ["Saved Searches"]
---

# Update Saved Search

`PUT /api/v1/user/searches/{searchId}/`

## Request

- Base URL: `https://urlscan.io`
- URL: `https://urlscan.io/api/v1/user/searches/{searchId}/`
- Auth: API key in header `api-key`

Update a Saved Search.

## Path parameters

- `searchId` string, required

## Request body

- SavedSearchRequest
  - `search` object, required
    - `datasource` 'hostnames' | 'scans', required: Which data this Saved Search operates on.
    - `createdAt` string, date-time: Time when the Saved Search was created.
    - `description` string: Short description.
    - `longDescription` string: Long description.
    - `name` string, required: User-facing short name.
    - `ownerDescription` string: User-facing owner description.
    - `permissions` string[]: Determine whether only other users on the same team or everyone on urlscan Pro can see the search.
    - `query` string, required: Search API query
    - `tlp` 'red' | 'amber+strict' | 'amber' | 'green' | 'clear': TLP (Traffic Light Protocol) indicator for other users on the urlscan Pro platform.
    - `usertags` string[]: User-supplied tags to be applied to matching items. Apply the following prefixes to tags to define their visibility scope: `pro.` (urlscan Pro users), `public.` (all registered users), `private.` (only you), or `team.` (you and team members).

## Response `200`

OK

- object
  - `search` SavedSearchResponse
    - `datasource` 'hostnames' | 'scans': Which data this Saved Search operates on.
    - `createdAt` string, date-time: Time when the Saved Search was created.
    - `description` string: Short description.
    - `longDescription` string: Long description.
    - `name` string: User-facing short name.
    - `ownerDescription` string: User-facing owner description.
    - `permissions` string[]: Determine whether only other users on the same team or everyone on urlscan Pro can see the search.
    - `query` string: Search API query
    - `tlp` 'red' | 'amber+strict' | 'amber' | 'green' | 'clear': TLP (Traffic Light Protocol) indicator for other users on the urlscan Pro platform.
    - `usertags` string[]: User-supplied tags to be applied to matching items. Apply the following prefixes to tags to define their visibility scope: `pro.` (urlscan Pro users), `public.` (all registered users), `private.` (only you), or `team.` (you and team members).
    - `_id` string: Unique ID of the Saved Search.

---

[API](https://skmtc.dev/urlscan/apis/urlscan-io-apis.md) - [All operations](https://skmtc.dev/urlscan/apis/urlscan-io-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/urlscan/apis/urlscan-io-apis/revisions/868c1c89a6e8?raw)