Saved Filters
List saved filters
Returns all saved filters for a workspace.
Needs a token with viewCostReports on the workspace.
query Parameters
workspaceId^wsp_[A-Za-z0-9_-]{2… · requiredpageThe page to return, counted from 1. A page below 1 reads page 1; one past the last returns no items.
limitItems per page, from 1 to 100. A larger value is clamped to 100, a smaller one to 1.
List saved filters › Responses
Success
Create saved filter
Creates a reusable filter configuration.
Needs a token with createSavedFilter on the workspace.
Headers
Idempotency-KeyA unique value, at most 255 printable ASCII characters, such as a UUID, that makes retrying this create safe. A retry with the same key and the same request within 24 hours answers the first response again, marked Idempotent-Replayed: true, and creates nothing; the same key with another request answers 422 idempotency_key_reused. A key is kept only for a create that succeeded. Without it, every request creates.
Create saved filter › Request Body
workspaceId^wsp_[A-Za-z0-9_-]{2… · requiredtitlefilterisDefaultCreate saved filter › Responses
Created
id^flt_[A-Za-z0-9_-]{2… · requiredtitleGet saved filter
Returns a specific saved filter.
Needs a token with viewCostReports on the workspace.
path Parameters
filterId^flt_[A-Za-z0-9_-]{2… · requiredquery Parameters
workspaceId^wsp_[A-Za-z0-9_-]{2… · requiredGet saved filter › Responses
Success
id^flt_[A-Za-z0-9_-]{2… · requiredtitlefilterisDefaultcreatedAtUpdate saved filter
Updates a saved filter.
Needs a token with updateSavedFilter on the workspace.
path Parameters
filterId^flt_[A-Za-z0-9_-]{2… · requiredquery Parameters
workspaceId^wsp_[A-Za-z0-9_-]{2… · requiredHeaders
If-MatchApplies the write only while the resource still has this ETag, and answers 412 precondition_failed otherwise. Without it, the last write wins.
Update saved filter › Request Body
titlefilterisDefaultUpdate saved filter › Responses
Success
id^flt_[A-Za-z0-9_-]{2… · requiredtitlefilterisDefaultcreatedAtDelete saved filter
Deletes a saved filter.
Needs a token with deleteSavedFilter on the workspace.
path Parameters
filterId^flt_[A-Za-z0-9_-]{2… · requiredquery Parameters
workspaceId^wsp_[A-Za-z0-9_-]{2… · requiredHeaders
If-MatchApplies the write only while the resource still has this ETag, and answers 412 precondition_failed otherwise. Without it, the last write wins.
Delete saved filter › Responses
No Content