Create label

API Endpoint

POST /label
Host: api.audicient.com
Authorization: <API_KEY>:<API_SECRET>
enterprise-id: 100001

Authentication Requirements

All requests must include authentication credentials.

  • Authorization Header: Pass the API key and secret as <API_KEY>:<API_SECRET>.

  • Enterprise-ID Header: Required when creating an label at the account level.

Request Body

Parameter
Type
Description

name

string

Name of the artist (minimum 2 characters).

description

string

Description of the artist (optional).

imageId

string

UUID of the image (nullable).

Example Request

{
  "name": "Example label",
  "description": "A sample artist description.",
  "imageId": "550e8400-e29b-41d4-a716-446655440000",
}

Success Response

{
  "status": 201,
  "success": true,
  "message": "Label has been created successfully",
  "data": {
    "labelId": 100004,
    "enterpriseId": 100003,
    "tenantId": "84df22ce-05de-4ca9-a4e3-b9187c4e4cb0",
    "name": "Example Label",
    "description": "",
    "imageId": null,
    "createdAt": "2025-03-13T15:02:33.391Z",
    "updatedAt": "2025-03-13T15:02:33.391Z"
  }
}

Last updated