Skip to navigation

Update a filter

View as Markdown
Update a filter

Authentication

AuthorizationToken

Your API key, sent as Authorization: Token <your API key>

Path parameters

filterIdstringRequiredformat: "uuid"
ID of the filter to update

Request

This endpoint expects an object.
idstringOptionalformat: "uuid"
typestringOptional>=1 character
namestringOptional1-150 characters
slugstringOptional>=1 character
orderintegerOptional>=0
parentFilterIdstringOptionalformat: "uuid"
parentFilterSlugstringOptional>=1 character
assignmentDescriptionstring or nullOptional<=150 characters
multipleSelectFromDashboardbooleanOptional
multipleLimitinteger or nullOptional1-250
multipleSelectFromDirectorybooleanOptional
userAssignablebooleanOptional
displayInDirectorybooleanOptional
displayInInternalDirectorybooleanOptional
displayInEntryProfilebooleanOptional
displayInInternalEntryProfilebooleanOptional
displayInEntryProfileMainAreabooleanOptional
requiredbooleanOptional
isLocationbooleanOptionalDefaults to false
Whether this is one of the Country, Region and City filters, which visitors pick from as one Location filter.
overridesobject or nullOptional
Visibility rule of the filter, or null when it has none.

Response

Details of the filter
namestring<=150 characters
orderintegerOptional>=0
assignmentDescriptionstring or nullOptional<=150 characters
multipleSelectFromDashboardbooleanOptional
multipleLimitinteger or nullOptional1-250
multipleSelectFromDirectorybooleanOptional
userAssignablebooleanOptional
displayInDirectorybooleanOptional
displayInInternalDirectorybooleanOptional
displayInEntryProfilebooleanOptional
displayInInternalEntryProfilebooleanOptional
displayInEntryProfileMainAreabooleanOptional
requiredbooleanOptional
overridesobject or nullOptional

A filter’s visibility rule, in the same shape as a form field’s overrides: when the conditions are met the filter takes the hidden value, otherwise the opposite one.

Errors

400
Bad Request Error
404
Not Found Error