How to Manage Your Labels with API

Last Update: February 4, 2026

Summarize with:

Efficient data organization is critical for high-volume operations. Our Labeling API provides a robust, programmatic way to categorize, group, and manage your digital assets. By using these endpoints, you can automate your Workspace structure and ensure that resources are seamlessly organized across your organization.

API Access Endpoints (Base URL)

To interact with the API, your Base URL is derived from the domain you use to access your dashboard.

If you access your account via: https://acme.serviceprovider.com/

Your API Base URL will be: https://acme.serviceprovider.com/API

Note

Simply replace the path after your Custom Domain with /API to direct your requests to the correct environment.

Ensure /API is capitalized, as these endpoints are case-sensitive.

Authentication

Secure access to the API is managed via your private API Key. Every request must be authenticated to prove you have permission to access the data. You can check How to Create an API Key to get your API Key. You can authenticate using one of the following methods:

HTTP Header: Pass your key in the request header using the following format: APIKEY: {yourKey} This is the most professional method and keeps your key out of the URL.
Query Parameter: For quick testing, you can append your key directly to the URL: https://acme.serviceprovider.com/API/user/labels?apiKey={yourKey}

Core Label Management

Use these endpoints to build and maintain your organizational category system.

Method	Endpoint	Description
GET	/user/labels	List All Labels: Retrieves every label created in your account.
POST	/label	Create New Label: Generates a new category (Name, Color, Parent ID).
GET	/label/{id}	Get Label Details: Fetches the configuration of a specific label.
PUT	/label/{id}	Update Label: Modifies the attributes of an existing label.
DELETE	/label/{id}	Delete Label: Permanently removes a label and its sub-labels.

Organizing Your Assets

Use these endpoints to manage the relationship between your labels and your resources.

Method	Endpoint	Event / Action
PUT	/label/{id}/add-resources	Add Items to Label: Links specific assets (IDs/Types) to a label.
PUT	/label/{id}/remove-resources	Remove Items: Unlinks assets from a label without deleting them.
GET	/label/{id}/resources	List Label Content: Shows every asset assigned to a specific label.