Add Labels

This API allows you to add new customer labels to your organization. Before using it, ensure the label limit for your organization is properly configured, as you cannot add labels beyond this number. This limit must be set at the organization level using the POST organization/configs API with the ORG_MAX_LABEL_COUNT parameter and cannot be configured through the user interface. If you attempt to add labels exceeding this limit, the system will block the request and return an error.

👍

Note

For detailed information about the APIs and for hands-on testing, refer to the API overview documentation and step-by-step guide on making your first API call.

Prerequisites

  • Basic Authentication
  • Default access group

Resource information

URL/v2/organization/labels
HTTP MethodPOST
PaginationNo
Batch supportNo
Rate limit informationThis endpoint supports 200 requests per minute per API key.

API Endpoint

https://eu.api.capillarytech.com/v2/organization/labels

Example request

curl --location 'https://eu.api.capillarytech.com/v2/organization/labels' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic *****' \
--header 'Cookie: _cfuvid=suFj8RO2mrlXOut2Fa7ukoWvca.9BKPkdKXq1mrH7Fg-1736904971714-0.0.1.1-604800000; _cfuvid=oQ3H153LTM8nT.gh0fhBj8XXHgFGhIKuoi8lOxyh.c4-1751970693920-0.0.1.1-604800000' \
--data '{
    "orgLabels": [
        {
            "name": "DocDemoLabel",
            "description":"Label for DocDemo"
        
        }
    ]
}'

Request Body Parameters

Parameter

Datatype

Description

orgLabels*

Array

List of labels to be added. Each object must include the fields below.

-name*

String

Name of the label.
Maximum length: 100 characters.
Minimum length: 1 character (cannot be null)
Special characters: Allowed

-description

String

Short description of the label. Maximum length: 255 characters.

Response Body Parameters

ParameterDatatypeDescription
entity*IntegerID of the created or updated entity.
warningsArray of stringList of warnings returned by the system. When no warnings are present, this array will be empty.

Error Code

Error CodeMessageDescription
200OKRequest processed successfully. The entity was created or updated without errors.
400Bad RequestThe request is invalid. Possible reasons include missing required parameters, invalid input data, or malformed request body.
401UnauthorizedAuthentication failed or the API token is missing or invalid.
403ForbiddenAccess is not allowed due to insufficient permissions.
404Not FoundThe requested resource was not found.
409ConflictThe request could not be completed due to a conflict with the current state of the resource.
500Internal Server ErrorAn unexpected error occurred on the server side.
33003Invalid ArrayThe request body contains an empty array. At least one valid object is required in the array.
Language
URL
Click Try It! to start a request and see the response here!