# Create a new view

Creates a new view for the specified object. The request body must contain the view details as a ViewDTO. Returns a CreateResponse containing the newly created view as a ViewDTO.

Endpoint: POST /api/v2/objects/{objectUuid}/views/
Version: 1.0
Security: BearerAuthentication

## Path parameters:

  - `objectUuid` (string, required)

## Request fields (application/json):

  - `uuid` (string, required)
    Unique identifier for the entity

  - `name` (string)

  - `label` (string)
    Display label for the entity, can be different from name

  - `createdAt` (integer)
    Unix timestamp when the entity was created

  - `createdBy` (object)
    Identifier of the user who created the entity

  - `createdBy.label` (string)

  - `createdBy.createdAt` (integer)

  - `createdBy.updatedAt` (integer)

  - `createdBy.deletedAt` (integer)

  - `createdBy.createdByUuid` (string)

  - `createdBy.updatedByUuid` (string)

  - `createdBy.deletedByUuid` (string)

  - `createdBy.index` (integer)

  - `createdBy.complete` (boolean)

  - `createdBy.deleted` (boolean)

  - `createdBy.uuid` (string, required)

  - `createdBy.objects` (object)

  - `createdBy.properties` (array)

  - `createdBy.properties.value` (any)

  - `createdBy.properties.type` (string)

  - `createdBy.properties.icon` (string)

  - `createdBy.user` (object)

  - `createdBy.user.email` (string)

  - `createdBy.user.firstname` (string)

  - `createdBy.user.lastname` (string)

  - `createdBy.user.initials` (string)

  - `createdBy.user.scopes` (array)

  - `createdBy.user.filters` (object)

  - `createdBy.user.role` (string)

  - `createdBy.user.record` (object)

  - `updatedAt` (integer)
    Unix timestamp when the entity was last updated

  - `updatedBy` (object)
    Identifier of the user who last updated the entity

  - `deletedAt` (integer)
    Unix timestamp when the entity was deleted (null if not deleted)

  - `deletedBy` (object)
    Identifier of the user who deleted the entity

  - `index` (integer)
    Index number for ordering entities

  - `favorite` (boolean)

  - `team` (boolean)

  - `shared` (boolean)

  - `personal` (boolean)

  - `trait` (string)

  - `filters` (object)
    DTO representing a filter composed of filter groups for querying records. The filter groups are combined using a logical OR operation. The filter items within each group are combined using a logical AND operation.

  - `filters.groups` (array)
    A collection of filter groups.

  - `filters.groups.items` (object)
    A set of filter items included in the group.

  - `filters.groups.items.object` (string)
    The name of the object to which this pagination item belongs.
    Example: "User"

  - `filters.groups.items.relation` (string)
    The relationship between objects.
    Example: "hasProperty"

  - `filters.groups.items.property` (string)
    The name of the property within the object.
    Example: "email"

  - `filters.groups.items.relationIncluded` (boolean)
    Specifies whether the relation is included.
    Example: true

  - `filters.groups.items.operator` (string)
    Defines the operator used in the filter. Available operators are defined in the API documentation.
    Example: "EQUALS"

  - `filters.groups.items.value` (any)
    Represents the value to filter against.
    Example: 12345

  - `shows` (array)

  - `shows.separator` (string)
    Separator string used to visually separate this item.
    Example: "|"

  - `shows.sticky` (boolean)
    Flag indicating whether this item is sticky and will stay fixed in the list.

  - `sorts` (array)

  - `sorts.direction` (string)
    The direction for sorting. Can be ASC (ascending) or DESC (descending).
    Enum: "ASC", "DESC"

  - `limit` (integer)

  - `showIcons` (boolean)

  - `groupProperty` (object)
    Represents a sortable item, including object, relation, property, and sort direction.

  - `rowHeight` (string)

  - `calculations` (array)

  - `calculations.property` (object)
    DTO representing an item with properties defined for displaying and handling in UI related operations.

  - `calculations.calculation` (string)

  - `query` (string)

  - `flowProperty` (string)

  - `defaultView` (boolean)

  - `isInternallyPublic` (boolean)

## Response 201 fields (application/json):

  - `message` (string)
    A message detailing the result of the operation.
    Example: "Success"

  - `data` (any)
    The data payload of the response, if any.

## Response 400 fields (*/*):

  - `message` (string)
    The error message providing details about the failure.
    Example: "Resource not found."

  - `errors` (object)
    A list of error types providing further details about the error.
    Example: [{"field":"name","message":"Name is required.","correctionSuggestion":"Please provide a name."}]

  - `errors.correctionSuggestion` (string, required)
    A suggestion on how to correct the error.
    Example: "Try uploading a different file type."

  - `errors.type` (string, required)
    The type of error.
    Enum: "VALIDATION", "NOT_FOUND", "TEST", "RELATION_NOT_ALLOWED", "INVALID_VALUE", "GENERAL", "INVALID_FILE_TYPE", "INTERNAL_SERVER_ERROR", "CARAER_ERROR", "INVALID_EMAIL", "INVALID_DATE"

  - `status` (integer)
    The HTTP status code associated with the error.
    Example: 400

  - `stackTrace` (string)

  - `roles` (array)
    Enum: "USER", "ADMIN", "RESELLER", "DEVELOPER", "SUPER_ADMIN"

  - `scopes` (array)

## Response 500 fields (*/*):

  - `message` (string)
    The error message providing details about the failure.
    Example: "Resource not found."

  - `errors` (object)
    A list of error types providing further details about the error.
    Example: [{"field":"name","message":"Name is required.","correctionSuggestion":"Please provide a name."}]

  - `errors.correctionSuggestion` (string, required)
    A suggestion on how to correct the error.
    Example: "Try uploading a different file type."

  - `errors.type` (string, required)
    The type of error.
    Enum: "VALIDATION", "NOT_FOUND", "TEST", "RELATION_NOT_ALLOWED", "INVALID_VALUE", "GENERAL", "INVALID_FILE_TYPE", "INTERNAL_SERVER_ERROR", "CARAER_ERROR", "INVALID_EMAIL", "INVALID_DATE"

  - `status` (integer)
    The HTTP status code associated with the error.
    Example: 400

  - `stackTrace` (string)

  - `roles` (array)
    Enum: "USER", "ADMIN", "RESELLER", "DEVELOPER", "SUPER_ADMIN"

  - `scopes` (array)