Skip to main content
DELETE
TypeScript SDK
Deletes a cached view query. This is idempotent — it returns success even if the query doesn’t exist or has already expired.
Connection capabilitiesThis endpoint requires a connection to have read content capabilities. For more information on connection capabilities, see the capabilities guide.

Errors

Returns a 400 or 429 HTTP response if the request exceeds the request limits.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2026-03-11.

Available options:
2026-03-11

Path Parameters

view_id
string
required

The ID of the view.

query_id
string
required

The ID of the query.

Response

object
string
required

The object type.

Allowed value: "view_query"
id
string<uuid>
required

The ID of the deleted view query.

deleted
boolean
required

Whether the view query was deleted.