Skip to content

All resources

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

NameInTypeRequiredDescription
projectIdpathintegeryesProject 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

NameInTypeRequiredDescription
projectIdpathintegeryesProject 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

NameInTypeRequiredDescription
idpathintegeryesSaved 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

NameInTypeRequiredDescription
idpathintegeryesSaved filter id

Responses

  • 200 OK · object
  • 401 Unauthorized · apimodel.ErrorEnvelope
  • 403 Forbidden · apimodel.ErrorEnvelope
  • 404 Not Found · apimodel.ErrorEnvelope