Update filter view

Updates an existing filter view by its ID.

Note: Only the owner of a filter view can update it, unless the user has admin permissions.

Path Parameters

ParameterTypeRequiredDescription
idintegerYesFilter view unique identifier

Body Fields

FieldTypeRequiredDescription
labelstringNoView display name
sharebooleanNoWhether to share with other users
favoritebooleanNoMark as favorite
byDefaultbooleanNoSet as default view for this scope
columnsarrayNoList of column names to display
filtersobjectNoFilter criteria
sortstringNoField name to sort by
directionstringNoSort direction: asc or desc

Response Fields

FieldTypeDescription
idintegerFilter view unique identifier
labelstringView display name
scopestringEntity scope
sharebooleanShared status
favoritebooleanFavorite status
byDefaultbooleanDefault view status
columnsarrayColumn configuration
filtersobjectFilter criteria
sortstringSort field
directionstringSort direction
createdAtdatetimeCreation timestamp
updatedAtdatetimeLast update timestamp

Response

  • 200 OK: Filter view successfully updated
  • 400 Bad Request: Invalid request body or validation error
  • 401 Unauthorized: Invalid or missing API key
  • 403 Forbidden: Not allowed to update this view
  • 404 Not Found: Filter view not found
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required
Body Params
string
boolean
boolean
Responses
200

Resource updated

400

Bad request

401

Unauthorized

404

Resource not found

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here!