Skip to main content
POST
Creates a filter that belongs to the token owner. It is private until you share it.
Scope filters:write.

​
Body parameters

​
string
required
1 to 100 characters. Two filters may have the same name.
​
string | null
Up to 500 characters.
​
string
required
The kind of object the query runs on, as for Search.
​
string
required
The query. It must parse; a query with a syntax error answers 422.
​
object[]
default:"[]"
Up to five keys, each { "field", "direction" }.
​
string[]
default:"[]"
The columns to show; none means the kind’s standard columns.

​
Response

Status 201 with the filter, in the shape of List filters.
Last modified on October 17, 2026