Skip to main content
The Saved filters API gives integrations the filters of the person who issued the token: the ones they own and the ones shared with them. Every call runs as that person, with their rights.

​
Scopes

Running a filter also needs the scope of the kind of object the filter searches, for example tasks:read for a filter of work items. Without it the answer is 403 INSUFFICIENT_SCOPE. Existing tokens do not get the new scopes automatically; issue a new token under Profile → Security.

​
Conventions

  • A filter you may not read does not exist. Its ID answers 404 NOT_FOUND, exactly like an ID that does not exist.
  • Who may do what. The owner and people with the right to edit change a filter’s query. Only the owner shares or hands over a filter, and only the owner deletes it; an administrator also deletes a shared one. See Share a filter.
  • Changes name their version. PATCH carries the updatedAt you read as baseUpdatedAt. A filter changed since answers 409 CONFLICT and nothing is overwritten.
  • Pages. Lists are paged with a cursor. limit defaults to 50 and is cut down to 100.
  • Strict bodies. Unknown fields are rejected with 422 VALIDATION_ERROR.
Last modified on October 17, 2026