Save Release

API Endpoint

POST /release/create/save
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 a release at the account level.

Request Body Schema

Release Details

Parameter	Type	Description
type	number	Required. Please select release type. 1 : Single, 2: EP, 3: Album
imageId	string	Required. Must be a valid UUID. Please upload artwork.
name	string	Required. Minimum 2 characters. Release title.
version	string	Optional. Release version. Cannot have this words: Original, Version, Remix, Mashup
languageId	number	Required. Metadata language ID.
artistId	number	Required. Main artist ID.
contributors	array	Optional. List of contributors.
primaryMusicStyleId	number	Required. Genre 1.
secondaryMusicStyleId	number	Optional. Genre 2.
pYear	string	Required. 4-digit year.
pLine	string	Required. Copyright holder.
cYear	string	Required. 4-digit year.
cLine	string	Required. Copyright holder.
previouslyReleased	boolean	Required. Indicates if the release was previously released.
previouslyReleasedDate	string	Optional. Date of previous release.
hasLabel	boolean	Required. Indicates if the release has a record label.
labelId	number	Optional. Label ID.
hasUpc	boolean	Required. Indicates if the release has a UPC.
upc	string	Optional. UPC code.
catalog	string	Optional. Catalog number.

Track Details

Parameter	Type	Description
audioId	string	Required. Must be a valid UUID.
name	string	Required. Minimum 2 characters. Track title.
version	string	Optional. Track version.
languageId	number	Required. Lyrics language ID.
artistId	number	Required. Main artist ID.
contributors	array	Optional. List of contributors.
explicitContent	boolean	Required. Indicates if the track contains explicit content.
hasIsrc	boolean	Required. Indicates if the track has an ISRC.
isrc	string	Optional. ISRC code.
trackOrigin	number	Required. Track type.
primaryMusicStyleId	number	Required. Genre 1.
secondaryMusicStyleId	number	Optional. Genre 2.
pYear	string	Required. 4-digit year.
pLine	string	Required. Copyright holder.
previewTime	number	Optional. Default is 40.
lyrics	string	Optional. Default is empty.
catalog	string	Optional. Catalog number.
composerContentsDTO	array	Required. List of composers and lyricists.

Contributors Object

Parameter	Type	Description
roleId	number	Contributor role ID (required).
artistId	number	Key artist ID (required).

composerContentsDTO Object

Parameter	Type	Description
roleId	number	Contributor role ID (required).
name	string	Contributor name (required).

Example Request

{
  "release": {
    "type": 1,
    "imageId": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Sample Release",
    "version": "1.0",
    "languageId": 2,
    "artistId": 12345,
    "contributors": [],
    "primaryMusicStyleId": 5,
    "secondaryMusicStyleId": 10,
    "pYear": "2024",
    "pLine": "Sample Copyright",
    "cYear": "2024",
    "cLine": "Sample Copyright",
    "previouslyReleased": false,
    "previouslyReleasedDate": null,
    "hasLabel": true,
    "labelId": 6789,
    "hasUpc": true,
    "upc": "123456789012",
    "catalog": "SAMPLE123"
  },
  "tracks": [
    {
      "audioId": "550e8400-e29b-41d4-a716-446655440001",
      "name": "Sample Track",
      "version": "1.0",
      "languageId": 2,
      "artistId": 12345,
      "contributors": [],
      "explicitContent": false,
      "hasIsrc": true,
      "isrc": "US-XYZ-24-00001",
      "trackOrigin": 1,
      "primaryMusicStyleId": 5,
      "secondaryMusicStyleId": 10,
      "pYear": "2024",
      "pLine": "Sample Copyright",
      "previewTime": 40,
      "lyrics": "Sample lyrics",
      "catalog": "SAMPLE123",
      "composerContentsDTO": [
        {
          "roleId": 1,
          "name": "Composer Name"
        }
      ]
    }
  ]
}

Success Response (201 Created)

{
  "status": 201
  "success": true,
  "message": "Release has been saved successfully",
  "data": {
    "releaseId": 100001
  }
}