Skip to navigation

Create a saved view

View as Markdown

Creates a saved table view for a definition within a space. Authorization: requires space:contribute on :spaceId — lacking it gives 403 (a caller without even space:read gets 404 first). Body: name (required), and optional fields[] ({ fieldKey, isVisible, width, position }), filters[] ({ fieldKey, subField?, operand, value }), sorts[] ({ fieldKey, direction }), filterLogic. Server sets isDefault/spaceId/definitionId. Invalid name/fields/operands → 422 validation_failed. Returns 201 with { view }.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired
definitionIdstringRequired

Request

isDefault, spaceId and definitionId are server-set.

namestringRequired1-200 characters
fieldslist of objectsOptional
filterslist of objectsOptional
sortslist of objectsOptional
filterLogicstringOptional>=1 character

Response

The created view.
viewobject

Errors

403
Forbidden Error
422
Unprocessable Entity Error