Search

Save Search

Store a search so it can be run again.

Sending id REPLACES that saved search rather than creating a second one - which is why a caller looping over a list should send the id back, not omit it. A saved search belonging to someone else comes back as a 404 rather than a 403, so a guessed id cannot confirm that it exists.

icp_query is stored verbatim and is not interpreted here.

post/search/saved-searches

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/search/saved-searches
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

titlestring required
scopestring required

What the saved search is over - contacts or companies today. Deliberately a free string rather than a closed enum, matching the app, which is designed to add more.

icp_queryobject required

The search itself. Opaque and round-tripped as-is.

idinteger nullable

Send the id of an existing saved search to REPLACE it.

Response

Successful Response

dataSearchDiscoveryPayload required

An open envelope for an autocomplete or filter-option result.

Changes