Delete a saved search

DELETE

/api/v1/search/saved/{id}

const url = 'https://example.com/api/v1/search/saved/example';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://example.com/api/v1/search/saved/example \
  --header 'Authorization: Bearer <token>'

Deletes a saved search. It requires a signed-in User with the data scope. It can return 401 if the session is missing or expired, 403 if access is denied and 404 if the requested item does not exist. Route: /api/v1/search/saved/{id}. Inputs: id. Do not automatically replay this operation after an uncertain result.

Authorizations

installationBearer
browserSession

Parameters

Path Parameters

required

string

Saved search id

Responses

204

Moved to the Trash

404

No such saved search for this user

application/json

The standard API error response: { "error": { ... } }.

object

error

required

Error details.

object

code

required

Stable machine-readable code.

string

Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable

details

One of:

object
null

Optional field or operation details.

object

key

additional properties

string

message

required

Safe text for logs or a user-facing error message.

string

Example

{
  "error": {
    "code": "bad_request"
  }
}