CRcraft
Views

POST /portfolio/{portfolioId}/views/{viewId}/validate

Changed on

Check a change to a portfolio view without making it — see validateWorkspaceViewCreate.

Request

  • Base URL
    https://api.craft.io
  • URL
    https://api.craft.io/portfolio/{portfolioId}/views/{viewId}/validate
  • Auth
    API key in header x-api-key

Path parameters

portfolioIdstring 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.

columnColorsobject

Per-column colours as #RRGGBB, keyed like columns. Send {} to clear. Duplicating a view: pass what get_view returned, or the copy loses them.

compactModestring

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

Response

The view as it would be after the change

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.

columnColorsRecordStringString

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

Changes