# Add Label

POST /

#### Description

Creates a new label within an organization, defining its name, description, and associated properties for categorizing objects.

Endpoint: POST /
Version: 1.0
Security: oauth2

## Request fields (application/json):

  - `name` (string, required)
    The name of the label.
    Example: "Acceptable use of assets"

  - `description` (string)
    The description of the label.
    Example: "List of acceptable uses of assets by company employees."

## Response 200 fields (application/json):

  - `id` (string)
    The unique identifier of the label.
    Example: "d88d505d-5199-11ee-a644-522476618ae8"

  - `orgId` (string)
    The unique identifier for the organization the label belongs to.
    Example: "ce83e3cd-5199-11ee-a644-522476618ae8"

  - `name` (string)
    The name of the label.
    Example: "Acceptable use of assets"

  - `description` (string)
    The description of the label.
    Example: "List of acceptable uses of assets by company employees."

  - `freshnessPolicy` (string)
    The freshness policy of an object. Set to 'manual' with a 'freshAsOfDate' value otherwise 'freshness' will be set to 'unknown'.
    Enum: "none", "manual"

  - `freshForDuration` (string)
    The duration after which label becomes stale.
    Example: "PT720H"

  - `freshness` (string)
    The freshness status of an object. Cannot be set if 'freshnessPolicy' is 'none' and 'freshAsOfDate' is null.
    Enum: "noFreshness", "fresh", "expired", "unknown"

  - `freshAsOfDate` (string)
    The date when the label was last marked 'fresh' (ISO-8601 format).
    Example: "2025-01-12T18:26:10.00.5365Z"

  - `freshAsOfNote` (string)
    The note populated when the label was marked 'fresh'.
    Example: "Initial freshness set"

  - `createdBy` (string)
    The unique identifier of the user who created the label.
    Example: "82d7c228-8bcd-11e9-a94b-ab3de8494987"

  - `createdOn` (string)
    The date and time the label was created (ISO-8601 format).
    Example: "2025-01-12T18:26:10.005365Z"

  - `updatedBy` (string)
    The unique identifier of the user who last updated the label.
    Example: "82d7c228-8bcd-11e9-a94b-ab3de8494987"

  - `updatedOn` (string)
    The date and time the label was last updated (ISO-8601 format).
    Example: "2025-01-12T18:26:10.005365Z"

  - `customFields` (array)
    The custom fields for the label.

  - `customFields.fieldId` (string)
    Unique identifier for the custom field

  - `customFields.fieldName` (string)
    Name of the custom field

  - `customFields.fieldType` (string)
    Type of field
    Enum: "text", "number", "date", "user", "textSingleSelect", "textMultiSelect"

  - `customFields.numberFormat` (string)
    Format if the field type is number
    Enum: "decimal", "percentage"

  - `customFields.textValue` (string)
    Value if the field type is text

  - `customFields.numberValue` (number)
    Value if the field type is number

  - `customFields.dateValue` (string)
    Value if the field type is date

  - `customFields.userValue` (string)
    Value if the field type is user

  - `customFields.selection` (string)
    Value for textSingleSelect

  - `customFields.selections` (array)
    List of values for textMultiSelect

  - `status` (string)
    The status of the object
    Enum: "active", "archived"

  - `permissions` (array)
    The list of permissions for the label.
    Example: []

  - `_isPartialData` (boolean)
    This is true when the user does not have read permissions on the label.