# Create new object

Creates a new Caraer object using the provided details. Optional request parameters specify whether to include views, properties, and relations in the response. Validation rules: label (required, must be a string, maximum 32 characters), plural (required, must be a string, maximum 32 characters), name (required, must be a string, must be lowercase, must be unique, must match name pattern (lowercase letters, numbers, underscores)), description (optional, maximum 255 characters), groups (required, must be an array of string, no duplicate values allowed), showInMenu (required, must be a boolean).

Endpoint: POST /api/v2/objects/
Version: 1.0
Security: BearerAuthentication

## Query parameters:

  - `views` (string)

  - `properties` (string)

  - `relations` (string)

## Request fields (application/json):

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

  - `name` (string)
    Unique identifier name for the object

  - `label` (string)
    Display label for the object

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

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

  - `createdBy.name` (string, required)

  - `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 objects

  - `plural` (string)
    Plural form of the object's name, used for display purposes

  - `description` (string)
    Detailed description of the object's purpose and usage

  - `groups` (array)
    Collection of group names this object belongs to

  - `icon` (string)
    Icon identifier for visual representation of the object

  - `showInMenu` (boolean)
    Indicates if this object should be displayed in navigation menus

  - `defaultTrait` (string)
    Name of the default trait applied to this object

  - `traits` (array)
    List of trait names associated with this object

  - `views` (array)
    List of view configurations for displaying this object

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

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

  - `views.favorite` (boolean)

  - `views.team` (boolean)

  - `views.shared` (boolean)

  - `views.personal` (boolean)

  - `views.trait` (string)

  - `views.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.

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

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

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

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

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

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

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

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

  - `views.shows` (array)

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

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

  - `views.sorts` (array)

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

  - `views.limit` (integer)

  - `views.showIcons` (boolean)

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

  - `views.rowHeight` (string)

  - `views.calculations` (array)

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

  - `views.calculations.calculation` (string)

  - `views.query` (string)

  - `views.flowProperty` (string)

  - `views.defaultView` (boolean)

  - `views.isInternallyPublic` (boolean)

  - `properties` (array)
    List of properties defined for this object

  - `properties.name` (string)
    The name identifier of the property

  - `properties.label` (string)
    Display label for the property

  - `properties.description` (string)
    Detailed description of the property's purpose and usage

  - `properties.type` (string)
    The data type of the property (e.g., 'string', 'number', 'date', etc.)

  - `properties.options` (array)
    List of predefined options for properties that support selection

  - `properties.options.color` (string)

  - `properties.options.disabled` (boolean)

  - `properties.options.usedIn` (object)

  - `properties.options.usedIn.recordUuids` (array)

  - `properties.options.usedIn.count` (integer)

  - `properties.group` (string)
    Group name for organizing related properties

  - `properties.format` (any)
    Format configuration for the property's display and validation

  - `properties.rules` (array)
    Collection of validation rules applied to the property

  - `properties.immutable` (boolean)
    Indicates if the property value cannot be modified after initial creation

  - `properties.hidden` (boolean)
    Indicates if the property should be hidden from view

  - `properties.nonPublic` (boolean)
    Indicates if the property should be excluded from public APIs

  - `properties.indexed` (boolean)
    Indicates if the property should be indexed for searching

  - `properties.editable` (boolean)
    Indicates if the property value can be modified

  - `properties.formatSettings` (object)
    Additional format-specific settings for the property

  - `properties.usedIn` (object)
    Information about where this property is used in the system

  - `properties.icon` (string)
    Icon identifier for visual representation of the property

  - `properties.webpagePublic` (boolean)
    Indicates if the property can be used in webpages

  - `properties.embeddable` (boolean)
    Indicates if the property can be embedded in other properties

  - `properties.minAndMaxValue` (object)
    The minimum and maximum value of the property

  - `properties.minAndMaxValue.t1` (integer)

  - `properties.minAndMaxValue.t2` (integer)

  - `relations` (array)
    List of relations this object has with other objects

  - `relations.name` (string)
    Unique identifier name for the relation

  - `relations.label` (string)
    Display label for the relation

  - `relations.description` (string)
    Detailed description of the relation's purpose and usage

  - `relations.objects` (array)
    Set of Caraer objects that are part of this relation

  - `suites` (array)
    List of suite names this object belongs to

## 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)