Sign in
Views

Change a view's filters, controllers, name or category.

patch/workspace/{workspaceId}/views/{viewId}

Path parameters

workspaceIdstring required
viewIdstring required

Request body

namestring
categorystring
replaceAllFiltersboolean
columnsstring[]

Ordered visible columns — table and okr-table only. Replaces the current set outright; there is no per-column merge.

Supported because the app changes columns on an existing view through the same call. Without it an agent asked to add one column had to recreate the whole view, which left the original behind as a duplicate.

layoutstring[]

Card fields — kanban, timeline and swimlanes only. Replaces the current set.

compactModestring

Card density, kanban / timeline / swimlanes only: compact or default.

Response

The updated view

viewIdstring required
namestring required
viewTypestring required
ownerType'personal' | 'workspace' required
categorystring
workspaceIdstring
portfolioIdstring
webUrlstring
columnsstring[]
layoutstring[]
compactModestring

Card density on a card-based view: compact or default.

filtersRecordStringUnknown required

Construct a type with a set of properties K of type T

listItemsParamsRecordStringString required

Construct a type with a set of properties K of type T

listItemsTool'list_items' | 'list_portfolio_items' | 'list_feedback_items' required

Which list tool listItemsParams belongs to. Feedback views are the reason this is stated rather than assumed — their items are not work items.

Changes

Changed in 1 of the 3 revisions of this API.1