saved-filters
4 endpoints
get /projects/{projectId}/saved-filters
List a project's saved filters
Requires authentication
Returns the saved board filters visible to the caller in the project: their own private filters plus every org-scoped filter in the org, ordered for the filter bar.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| projectId | path | integer | yes | Project id |
Responses
- 200 OK · object
- 401 Unauthorized · apimodel.ErrorEnvelope
- 403 Forbidden · apimodel.ErrorEnvelope
- 404 Not Found · apimodel.ErrorEnvelope
post /projects/{projectId}/saved-filters
Create a saved filter
Requires authentication
Creates a named board filter in the project. Required: name, config. `config` is stored opaquely as JSON and never interpreted by the server.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| projectId | path | integer | yes | Project id |
Request body: object
No fields documented.
Responses
- 201 Created · object
- 400 Bad Request · apimodel.ErrorEnvelope
- 401 Unauthorized · apimodel.ErrorEnvelope
- 403 Forbidden · apimodel.ErrorEnvelope
patch /saved-filters/{id}
Update a saved filter
Requires authentication
Partially updates a saved filter. Only the creator may edit a locked org-scoped filter, or change `scope` / `isLocked` on any filter.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | yes | Saved filter id |
Request body: object
No fields documented.
Responses
- 200 OK · object
- 400 Bad Request · apimodel.ErrorEnvelope
- 401 Unauthorized · apimodel.ErrorEnvelope
- 403 Forbidden · apimodel.ErrorEnvelope
- 404 Not Found · apimodel.ErrorEnvelope
delete /saved-filters/{id}
Delete a saved filter
Requires authentication
Deletes a saved filter and returns a deleted flag. Only the creator may delete a locked org-scoped filter.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | yes | Saved filter id |
Responses
- 200 OK · object
- 401 Unauthorized · apimodel.ErrorEnvelope
- 403 Forbidden · apimodel.ErrorEnvelope
- 404 Not Found · apimodel.ErrorEnvelope