Skip to navigation
API ReferenceBoardsFilters

Update filter

View as Markdown

The token name itself comes from widget SQL and cannot be changed here. Switching filter_type to dropdown requires dropdown_options.

Path parameters

org_idstringRequired
Organization ID
workspace_idstringRequired
Workspace ID
board_idstringRequiredformat: "uuid"

Board ID, as returned in id by Create board or List boards. Must be a UUID; anything else is rejected with 422.

filter_idstringRequiredformat: "uuid"

Filter ID, from List filters. Must be a UUID; anything else is rejected with 422.

Headers

X-API-KeystringRequired
Your workspace API key.

Request

This endpoint expects an object.
display_labelstring or nullOptional1-80 characters
New label
filter_typeenum or nullOptional
New declared value type
Allowed values:
default_valuestring or nullOptional

New default, or null to remove it. For a date filter, use a full ISO 8601 timestamp with an offset, e.g. 2026-09-01T00:00:00+05:30; a date-only value fails with INVALID_FILTER_VALUE.

dropdown_optionslist of objects or nullOptional

Replacement options. Required when changing filter_type to dropdown.

Response

Successful Response
filter_idstringformat: "uuid"
Identifier of the updated filter

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error