Revelator Logo API
v1

Physical Releases

The Physical Releases API allows you to manage metadata for physical music and video products—vinyl records, CDs, cassettes, DVDs, Blu-rays, and more. Each release is tied to a specific configuration (e.g., “Vinyl Album” or “DVD Video”) that dictates the available metadata fields and required assets.

Physical releases are metadata-only: they do not support inventory, stock management, SKUs, manufacturing workflows, or physical distribution. They can optionally be linked to an existing digital release to create a unified, multi-format catalog record.

Cover artwork and additional media files must be uploaded using the Files API before they can be referenced here. Files uploaded via V1.0 API upload endpoints are not compatible with these endpoints.

Category-Specific Fields

Physical releases support two categories: audio and video. The category is determined by the selected physicalReleaseConfigurationId (see the Get Release Configuration endpoint).

You should only use category-specific fields when they match the configuration’s category:

CategoryApplicable Fields
audioaudioLanguageId, audioPresentationType
videovideoType, videoCountryId, videoSubtitledLanguageId, videoDubbedLanguageId, videoDubbedCountryId, videoReleaseYear, videoProductionCompanies

If a field does not apply to the selected category, leave it empty (null) or omit it from your payload.

UI Usage vs. API Usage

You can use these API endpoints to create and manage physical releases immediately without any configuration.

However, by default, the Physical Releases feature is hidden in the Revelator Web Interface. If you want your users to be able to view and edit physical releases in the UI, a parent enterprise admin must navigate to Settings → Client Features and toggle Physical Releases to ON.

Retrieving by Asset ID

Because physical releases are part of the broader Assets architecture, they can be retrieved using either their specific physicalReleaseId or their universal assetId. (For more context, see Getting Started → Understanding Assets & IDs).

If your system relies on assetId, you can use the following alternative endpoints. They return the exact same data structures as the primary endpoints documented below:

Note: For brevity, only the primary physicalReleaseId endpoints are fully detailed on this page.

Get Release Configuration

GET /catalog/v1/physical-releases/configurations

Retrieves the list of available physical configurations.

Responses

object
physicalReleaseConfigurationId integer
displayName string
category PhysicalReleaseConfigurationCategory
Allowed values: audio, video
formatGroupName string
GET /catalog/v1/physical-releases/configurations 
curl -X GET "https://platform.revelator.com/catalog/v1/physical-releases/configurations" -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Example response 200 
[
{
  "physicalReleaseConfigurationId": 2,
  "displayName": "Vinyl Album",
  "category": "audio",
  "formatGroupName": "Vinyl"
},
{
  "physicalReleaseConfigurationId": 21,
  "displayName": "CD Album",
  "category": "audio",
  "formatGroupName": "CD"
},
{
  "physicalReleaseConfigurationId": 31,
  "displayName": "DVD Audio",
  "category": "video",
  "formatGroupName": "DVD"
}
]

Create Physical Release

POST /catalog/v1/physical-releases

Creates a new physical release.

Request Body *

object
name * string
Name of the physical release.
version string
Version or subtitle for the release (e.g., "Deluxe Edition").
displayLabel string
Brand name shown on storefronts and packaging.
description string
Textual description of the release.
linerNotes string
The printed booklet or insert text included with this physical product (credits, lyrics, artwork notes, etc.).
assetId * integer
Asset ID of a track to include in the release.
assetType * AssetTypes
Asset type for each listed asset.
Example: Track
discNumber * integer
The physical disc or volume number on which the track appears. For standard single-disc releases, set this value to '1'.
explicit boolean
Marks whether the release content is explicit.
releaseDate * string (date-time)
The date this physical edition went on sale. Must be a past date; future release dates are not supported.
historicalReleaseDate string (date-time)
Historical first-release date across any format.
upc * string
UPC code for the physical release.
catalog string
Catalog number.
isPromotional boolean
Indicates whether this is a promotional release. A non-commercial copy intended for press or broadcast use only.
isBoxSet boolean
Indicates whether this release is a box set. Set automatically for box set configurations, but can be applied manually to bundled editions.
isIndieExclusive boolean
Indicates whether this is an indie exclusive (e.g., Record Store Day releases or boutique distributor exclusives).
copyrightP * string
Phonogram copyright notice (P line). Sound recording rights. Enter the year and the name of the rights holder for the master recording.
copyrightC * string
Composition/artwork copyright notice (C line). Enter the year and the name of the rights holder for the visual and written content.
copyrightV string
Video copyright notice. The Vanity Line is sent to select partners alongside the Ⓟ and © lines for marketing credits.
audioPresentationType AudioPresentationType
The mastering or surround format of this release (e.g., Stereo, Mono, CD Master, Vinyl Master).
Examples: dolbySurround51, dolbySurround71, dtsSurround51, dtsSurround71, specializedMaster, cdMaster, vinylMaster, mono, stereo
videoType VideoType
The category that best describes the content of this release.
Examples: featureFilm, musicVideoAlbum, concertOrLivePerformance, documentary, tvSpecial, shortFilm, interviewOrBehindTheScenes, compilationOrAnthology, visualAlbum, animationOrAnimatedFeature, educationalOrInstructional, promotionalOrMarketing
videoProductionCompanies string[]
List of video production company names.
videoReleaseYear integer
The year this film or video was originally completed or first released.
videoDubbedCountryId integer
Country ID for dubbed audio.
videoDubbedLanguageId integer
The language used for the dubbed audio track, if applicable.
videoSubtitledLanguageId integer
The primary language of on-screen subtitles included on this release.
videoCountryId integer
Country ID associated with the video.
audioLanguageId integer
The language of the spoken or sung content on this release.
labelId * integer
Label ID for the release.
primaryMusicStyleId * integer
Primary music style ID.
secondaryMusicStyleId integer
Secondary music style ID.
artistId * integer
Primary artist ID.
metadataCountryId integer
Use the Country field to specify a regional variant (e.g., English US vs. English UK).
metadataLanguageId * integer
The language in which all titles, descriptions, and credits for this release are written.
coverArtworkFileId * string
File ID (GUID) of the cover artwork, generated by the Files API.
additionalMedia string[]
List of additional media file IDs (GUIDs).
physicalReleaseConfigurationId * integer
Physical release configuration ID (e.g., Vinyl, CD, DVD).
originalReleaseId integer
Original digital release ID linked to this physical release.

Responses

object
physicalReleaseId integer
assetId integer
name string
version string | null
displayLabel string | null
description string | null
linerNotes string | null
assetId integer
assetType AssetTypes
Allowed values: releaseTrack, release, youTubeChannel, track, youTubeVideo, video, musicalWork, physicalRelease
discNumber integer
explicit boolean
releaseDate string (date-time)
historicalReleaseDate string (date-time) | null
upc string
catalog string | null
isPromotional boolean
isBoxSet boolean
isIndieExclusive boolean
copyrightP string
copyrightC string
copyrightV string | null
audioPresentationType AudioPresentationType
Allowed values: dolbySurround51, dolbySurround71, dtsSurround51, dtsSurround71, specializedMaster, cdMaster, vinylMaster, mono, stereo
videoType VideoType
Allowed values: featureFilm, musicVideoAlbum, concertOrLivePerformance, documentary, tvSpecial, shortFilm, interviewOrBehindTheScenes, compilationOrAnthology, visualAlbum, animationOrAnimatedFeature, educationalOrInstructional, promotionalOrMarketing
videoProductionCompanies string[] | null
videoReleaseYear integer | null
videoDubbedCountryId integer | null
videoDubbedLanguageId integer | null
videoSubtitledLanguageId integer | null
videoCountryId integer | null
audioLanguageId integer | null
labelId integer
primaryMusicStyleId integer
secondaryMusicStyleId integer | null
artistId integer
metadataCountryId integer | null
metadataLanguageId integer
coverArtworkFileId string
additionalMedia string[] | null
physicalReleaseConfigurationId integer
originalReleaseId integer | null
tenantId integer
enterpriseId integer
creationDate string (date-time)
lastUpdateDate string (date-time)
archivedAt string (date-time) | null
POST /catalog/v1/physical-releases 
curl -X POST "https://platform.revelator.com/catalog/v1/physical-releases" -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
  "name": "Midnight Tides",
  "version": "Deluxe",
  "displayLabel": "Midnight Tides (Deluxe)",
  "description": "Special gatefold vinyl edition.",
  "linerNotes": "Recorded in Berlin.",
  "assets": [
    {
      "assetId": 4419835,
      "assetType": "track",
      "discNumber": 1
    }
  ],
  "explicit": false,
  "releaseDate": "2026-02-14T00:00:00Z",
  "historicalReleaseDate": null,
  "upc": "843563172001",
  "catalog": "NR-2026-014",
  "isPromotional": false,
  "isBoxSet": false,
  "isIndieExclusive": true,
  "copyrightP": "2026 Northline Records",
  "copyrightC": "2026 Northline Records",
  "audioPresentationType": "vinylMaster",
  "videoType": null,
  "videoProductionCompanies": null,
  "videoReleaseYear": null,
  "videoDubbedCountryId": null,
  "videoDubbedLanguageId": null,
  "videoSubtitledLanguageId": null,
  "videoCountryId": null,
  "audioLanguageId": 1,
  "labelId": 120,
  "primaryMusicStyleId": 17,
  "secondaryMusicStyleId": null,
  "artistId": 4402,
  "metadataCountryId": 840,
  "metadataLanguageId": 1,
  "coverArtworkFileId": "f9af4e20-03b6-4f49-b7a8-a8d20ca8ddc2",
  "additionalMedia": [
    "0f55b5b4-ea85-46a0-b778-d4b1ded47e2f"
  ],
  "physicalReleaseConfigurationId": 2,
  "originalReleaseId": null
}'
Example response 200 
{
"physicalReleaseId": 9021,
"assetId": 5001201,
"name": "Midnight Tides",
"version": "Deluxe",
"displayLabel": "Midnight Tides (Deluxe)",
"description": "Special gatefold vinyl edition.",
"linerNotes": "Recorded in Berlin.",
"assets": [
  {
    "assetId": 4419835,
    "assetType": "track",
    "discNumber": 1
  }
],
"explicit": false,
"releaseDate": "2026-02-14T00:00:00Z",
"historicalReleaseDate": null,
"upc": "843563172001",
"catalog": "NR-2026-014",
"isPromotional": false,
"isBoxSet": false,
"isIndieExclusive": true,
"copyrightP": "2026 Northline Records",
"copyrightC": "2026 Northline Records",
"copyrightV": null,
"audioPresentationType": "vinylMaster",
"videoType": null,
"videoProductionCompanies": null,
"videoReleaseYear": null,
"videoDubbedCountryId": null,
"videoDubbedLanguageId": null,
"videoSubtitledLanguageId": null,
"videoCountryId": null,
"audioLanguageId": 1,
"labelId": 120,
"primaryMusicStyleId": 17,
"secondaryMusicStyleId": null,
"artistId": 4402,
"metadataCountryId": 840,
"metadataLanguageId": 1,
"coverArtworkFileId": "f9af4e20-03b6-4f49-b7a8-a8d20ca8ddc2",
"additionalMedia": [
  "0f55b5b4-ea85-46a0-b778-d4b1ded47e2f"
],
"physicalReleaseConfigurationId": 2,
"originalReleaseId": null,
"tenantId": 2001,
"enterpriseId": 3001,
"creationDate": "2026-01-10T12:03:43Z",
"lastUpdateDate": "2026-01-10T12:03:43Z",
"archivedAt": null
}

Get Physical Release

GET /catalog/v1/physical-releases/{physicalReleaseId}

Retrieves a physical release by its ID.

Path Parameters

Parameter Description
physicalReleaseId * integer

The ID of the physical release.

Responses

object
physicalReleaseId integer
assetId integer
name string
version string | null
displayLabel string | null
description string | null
linerNotes string | null
assetId integer
assetType AssetTypes
Allowed values: releaseTrack, release, youTubeChannel, track, youTubeVideo, video, musicalWork, physicalRelease
discNumber integer
explicit boolean
releaseDate string (date-time)
historicalReleaseDate string (date-time) | null
upc string
catalog string | null
isPromotional boolean
isBoxSet boolean
isIndieExclusive boolean
copyrightP string
copyrightC string
copyrightV string | null
audioPresentationType AudioPresentationType
Allowed values: dolbySurround51, dolbySurround71, dtsSurround51, dtsSurround71, specializedMaster, cdMaster, vinylMaster, mono, stereo
videoType VideoType
Allowed values: featureFilm, musicVideoAlbum, concertOrLivePerformance, documentary, tvSpecial, shortFilm, interviewOrBehindTheScenes, compilationOrAnthology, visualAlbum, animationOrAnimatedFeature, educationalOrInstructional, promotionalOrMarketing
videoProductionCompanies string[] | null
videoReleaseYear integer | null
videoDubbedCountryId integer | null
videoDubbedLanguageId integer | null
videoSubtitledLanguageId integer | null
videoCountryId integer | null
audioLanguageId integer | null
labelId integer
primaryMusicStyleId integer
secondaryMusicStyleId integer | null
artistId integer
metadataCountryId integer | null
metadataLanguageId integer
coverArtworkFileId string
additionalMedia string[] | null
physicalReleaseConfigurationId integer
originalReleaseId integer | null
tenantId integer
enterpriseId integer
creationDate string (date-time)
lastUpdateDate string (date-time)
archivedAt string (date-time) | null
GET /catalog/v1/physical-releases/{physicalReleaseId} 
curl -X GET "https://platform.revelator.com/catalog/v1/physical-releases/9021" -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Example response 200 
{
"physicalReleaseId": 9021,
"assetId": 5001201,
"name": "Midnight Tides",
"version": "Deluxe",
"displayLabel": "Midnight Tides (Deluxe)",
"description": "Special gatefold vinyl edition.",
"linerNotes": "Recorded in Berlin.",
"assets": [
  {
    "assetId": 4419835,
    "assetType": "track",
    "discNumber": 1
  }
],
"explicit": false,
"releaseDate": "2026-02-14T00:00:00Z",
"historicalReleaseDate": null,
"upc": "843563172001",
"catalog": "NR-2026-014",
"isPromotional": false,
"isBoxSet": false,
"isIndieExclusive": true,
"copyrightP": "2026 Northline Records",
"copyrightC": "2026 Northline Records",
"copyrightV": null,
"audioPresentationType": "vinylMaster",
"videoType": null,
"videoProductionCompanies": null,
"videoReleaseYear": null,
"videoDubbedCountryId": null,
"videoDubbedLanguageId": null,
"videoSubtitledLanguageId": null,
"videoCountryId": null,
"audioLanguageId": 1,
"labelId": 120,
"primaryMusicStyleId": 17,
"secondaryMusicStyleId": null,
"artistId": 4402,
"metadataCountryId": 840,
"metadataLanguageId": 1,
"coverArtworkFileId": "f9af4e20-03b6-4f49-b7a8-a8d20ca8ddc2",
"additionalMedia": [
  "0f55b5b4-ea85-46a0-b778-d4b1ded47e2f"
],
"physicalReleaseConfigurationId": 2,
"originalReleaseId": null,
"tenantId": 2001,
"enterpriseId": 3001,
"creationDate": "2026-01-10T12:03:43Z",
"lastUpdateDate": "2026-02-01T08:20:10Z",
"archivedAt": null
}

List Physical Releases

GET /catalog/v1/physical-releases

Returns a paginated list of physical releases based on filters and sorting options.

Query Parameters

Parameter Description
releaseDateFrom string (date-time)

Include releases with a release date on or after this UTC date-time.
releaseDateTo string (date-time)

Include releases with a release date on or before this UTC date-time.
creationDateFrom string (date-time)

Include releases created on or after this UTC date-time.
creationDateTo string (date-time)

Include releases created on or before this UTC date-time.
archived boolean

Filter by archive state (`true` for archived, `false` for active).
archivedFrom string (date-time)

Include releases archived on or after this UTC date-time.
archivedTo string (date-time)

Include releases archived on or before this UTC date-time.
physicalReleaseConfigurationIds integer[]

Filter by one or more physical release configuration IDs.
primaryMusicStyleIds integer[]

Filter by one or more primary music style IDs.
metadataLanguageIds integer[]

Filter by one or more metadata language IDs.
enterpriseIds integer[]

Filter by one or more enterprise IDs.
originalReleaseIds integer[]

Filter by one or more original release IDs.
searchText string

Free-text search applied to supported physical release fields.
pageNumber integer

Page number for paginated results.
pageSize integer

Number of items per page.
orderByProperty string

Property name used for sorting.
orderByDescending boolean

Set to `true` for descending order, `false` for ascending.

Responses

object
pageNumber integer
The current page number in the paginated result set (1-indexed)
pageSize integer
The number of items per page in the paginated result set
totalItemsCount integer
The total number of items available across all pages
totalPagesCount number
The total number of pages available based on the page size
physicalReleaseId integer
assetId integer
name string | null
version string | null
displayLabel string | null
upc string | null
releaseDate string (date-time)
explicit boolean
originalReleaseId integer | null
artistId integer
artistName string | null
labelId integer
labelName string | null
physicalReleaseConfigurationId integer
physicalReleaseConfigurationCategory PhysicalReleaseConfigurationCategory
Allowed values: audio, video
physicalReleaseConfigurationName string
primaryMusicStyleId integer
primaryMusicStyleName string | null
metadataLanguageId integer
metadataLanguageName string | null
coverArtworkFileId string | null
tenantId integer
enterpriseId integer
enterpriseName string
creationDate string (date-time) | null
lastUpdateDate string (date-time) | null
archivedAt string (date-time) | null
GET /catalog/v1/physical-releases 
curl -X GET "https://platform.revelator.com/catalog/v1/physical-releases?pageNumber=1&pageSize=20&physicalReleaseConfigurationIds=39&orderByProperty=releaseDate&orderByDescending=true" -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Example response 200 
{
"pageNumber": 1,
"pageSize": 20,
"totalItemsCount": 1,
"totalPagesCount": 1,
"items": [
  {
          "physicalReleaseId": 54,
          "assetId": 4555261,
          "name": "Release name",
          "version": "Deluxe",
          "displayLabel": "Label",
          "upc": "4444444444444",
          "releaseDate": "2026-03-11T00:00:00Z",
          "explicit": false,
          "originalReleaseId": null,
          "artistId": 533791,
          "artistName": "Name",
          "labelId": 331730,
          "labelName": "Label",
          "physicalReleaseConfigurationId": 39,
          "physicalReleaseConfigurationCategory": "video",
          "physicalReleaseConfigurationName": "VHS",
          "primaryMusicStyleId": 41,
          "primaryMusicStyleName": "Hip Hop/Rap",
          "metadataLanguageId": 30,
          "metadataLanguageName": "Polish",
          "coverArtworkFileId": "beebbd22-c1b4-4a8c-84b8-5b4b9a25addd",
          "tenantId": 127038,
          "enterpriseId": 237602,
          "enterpriseName": "Client Name",
          "creationDate": "2026-03-17T11:53:26.027Z",
          "lastUpdateDate": "2026-03-17T11:53:26.027Z",
          "archivedAt": null
  }
]
}

List Physical Release Assets

GET /catalog/v1/physical-releases/{physicalReleaseId}/assets

Retrieves assets linked to a physical release ID.

Path Parameters

Parameter Description
physicalReleaseId * integer

The ID of the physical release.

Responses

object[]
assetId integer
assetType AssetTypes
Allowed values: releaseTrack, release, youTubeChannel, track, youTubeVideo, video, musicalWork, physicalRelease
name string
version string | null
artistId integer | null
artistName string | null
isrc string | null
recordingVersionType WellKnownRecordingVersionType
Allowed values: stereo, dolbyAtmos
fileId string | null
duration integer | null
GET /catalog/v1/physical-releases/{physicalReleaseId}/assets 
curl -X GET "https://platform.revelator.com/catalog/v1/physical-releases/9021/assets" -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Example response 200 
[
{
  "assetId": 4419835,
  "assetType": "track",
  "name": "Night Lights",
  "version": "Remastered",
  "artistId": 4402,
  "artistName": "Nova Days",
  "recordingVersions": [
    {
      "isrc": "QZ8AB2600011",
      "recordingVersionType": "stereo",
      "recordingFiles": [
        {
          "fileId": "d12fd57a-e739-44fd-9246-31f50d4ee5f6",
          "duration": 223
        }
      ]
    }
  ]
}
]

Update Physical Release

PUT /catalog/v1/physical-releases/{physicalReleaseId}

Updates an existing physical release by its ID.

Path Parameters

Parameter Description
physicalReleaseId * integer

The ID of the physical release to update.

Request Body *

object
name * string
Name of the physical release.
version string
Version or subtitle for the release.
displayLabel string
Brand name shown on storefronts and packaging.
description string
Textual description.
linerNotes string
The printed booklet or insert text included with this physical product.
assetId integer
Asset ID of a track to include in the release.
assetType AssetTypes
Asset type for each listed asset.
discNumber integer
Disc number position for each asset in multi-disc releases.
explicit boolean
Marks whether release content is explicit.
releaseDate * string (date-time)
The date this physical edition went on sale. Must be a past date; future release dates are not supported.
historicalReleaseDate string (date-time)
Historical first-release date across any format.
upc * string
UPC code for the physical release.
catalog string
Catalog number.
isPromotional boolean
Indicates whether this is a promotional release.
isBoxSet boolean
Indicates whether this release is a box set.
isIndieExclusive boolean
Indicates whether this is marked as indie exclusive.
copyrightP * string
Phonogram copyright notice (P line). Sound recording rights. Enter the year and the name of the rights holder for the master recording.
copyrightC * string
Composition/artwork copyright notice (C line). Enter the year and the name of the rights holder for the visual and written content.
copyrightV string
Video copyright notice. The Vanity Line is sent to select partners alongside the Ⓟ and © lines.
audioPresentationType AudioPresentationType
The mastering or surround format of this release.
Examples: dolbySurround51, dolbySurround71, dtsSurround51, dtsSurround71, specializedMaster, cdMaster, vinylMaster, mono, stereo
videoType VideoType
The category that best describes the content of this release, e.g. Feature Film, Concert, Documentary.
Examples: featureFilm, musicVideoAlbum, concertOrLivePerformance, documentary, tvSpecial, shortFilm, interviewOrBehindTheScenes, compilationOrAnthology, visualAlbum, animationOrAnimatedFeature, educationalOrInstructional, promotionalOrMarketing
videoProductionCompanies string[]
List of video production company names.
videoReleaseYear integer
The year this film or video was originally completed or first released.
videoDubbedCountryId integer
Country ID for dubbed audio.
videoDubbedLanguageId integer
The language used for the dubbed audio track.
videoSubtitledLanguageId integer
The primary language of on-screen subtitles included on this release.
videoCountryId integer
Country ID associated with the video.
audioLanguageId integer
The language of the spoken or sung content on this release.
labelId * integer
Label ID for the release.
primaryMusicStyleId * integer
Primary music style ID.
secondaryMusicStyleId integer
Secondary music style ID.
artistId * integer
Primary artist ID.
metadataCountryId integer
Use the Country field to specify a regional variant.
metadataLanguageId * integer
The language in which all titles, descriptions, and credits for this release are written.
coverArtworkFileId * string
File ID (GUID) of the cover artwork.
additionalMedia string[]
List of additional media file IDs (GUIDs).
physicalReleaseConfigurationId * integer
Physical release configuration ID (for example, Vinyl, CD, DVD).
originalReleaseId integer
Original release ID linked to this physical release.

Responses

object
physicalReleaseId integer
assetId integer
name string
version string | null
displayLabel string | null
description string | null
linerNotes string | null
assetId integer
assetType AssetTypes
Allowed values: releaseTrack, release, youTubeChannel, track, youTubeVideo, video, musicalWork, physicalRelease
discNumber integer
explicit boolean
releaseDate string (date-time)
historicalReleaseDate string (date-time) | null
upc string
catalog string | null
isPromotional boolean
isBoxSet boolean
isIndieExclusive boolean
copyrightP string
copyrightC string
copyrightV string | null
audioPresentationType AudioPresentationType
Allowed values: dolbySurround51, dolbySurround71, dtsSurround51, dtsSurround71, specializedMaster, cdMaster, vinylMaster, mono, stereo
videoType VideoType
Allowed values: featureFilm, musicVideoAlbum, concertOrLivePerformance, documentary, tvSpecial, shortFilm, interviewOrBehindTheScenes, compilationOrAnthology, visualAlbum, animationOrAnimatedFeature, educationalOrInstructional, promotionalOrMarketing
videoProductionCompanies string[] | null
videoReleaseYear integer | null
videoDubbedCountryId integer | null
videoDubbedLanguageId integer | null
videoSubtitledLanguageId integer | null
videoCountryId integer | null
audioLanguageId integer | null
labelId integer
primaryMusicStyleId integer
secondaryMusicStyleId integer | null
artistId integer
metadataCountryId integer | null
metadataLanguageId integer
coverArtworkFileId string
additionalMedia string[] | null
physicalReleaseConfigurationId integer
originalReleaseId integer | null
tenantId integer
enterpriseId integer
creationDate string (date-time)
lastUpdateDate string (date-time)
archivedAt string (date-time) | null
PUT /catalog/v1/physical-releases/{physicalReleaseId} 
curl -X PUT "https://platform.revelator.com/catalog/v1/physical-releases/9021" -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
  "name": "Midnight Tides",
  "version": "Expanded Edition",
  "displayLabel": "Midnight Tides (Expanded)",
  "description": "Updated notes for second press.",
  "linerNotes": "Second pressing, remastered lacquers.",
  "assets": [
    {
      "assetId": 4419835,
      "assetType": "track",
      "discNumber": 1
    },
    {
      "assetId": 4419836,
      "assetType": "track",
      "discNumber": 1
    }
  ],
  "explicit": false,
  "releaseDate": "2026-02-14T00:00:00Z",
  "historicalReleaseDate": "2025-11-10T00:00:00Z",
  "upc": "843563172001",
  "catalog": "NR-2026-014B",
  "isPromotional": false,
  "isBoxSet": false,
  "isIndieExclusive": true,
  "copyrightP": "2026 Northline Records",
  "copyrightC": "2026 Northline Records",
  "audioPresentationType": "vinylMaster",
  "videoType": null,
  "videoProductionCompanies": null,
  "videoReleaseYear": null,
  "videoDubbedCountryId": null,
  "videoDubbedLanguageId": null,
  "videoSubtitledLanguageId": null,
  "videoCountryId": null,
  "audioLanguageId": 1,
  "labelId": 120,
  "primaryMusicStyleId": 17,
  "secondaryMusicStyleId": 22,
  "artistId": 4402,
  "metadataCountryId": 840,
  "metadataLanguageId": 1,
  "coverArtworkFileId": "f9af4e20-03b6-4f49-b7a8-a8d20ca8ddc2",
  "additionalMedia": [
    "0f55b5b4-ea85-46a0-b778-d4b1ded47e2f"
  ],
  "physicalReleaseConfigurationId": 2,
  "originalReleaseId": null
}'
Example response 200 
{
"physicalReleaseId": 9021,
"assetId": 5001201,
"name": "Midnight Tides",
"version": "Expanded Edition",
"displayLabel": "Midnight Tides (Expanded)",
"description": "Updated notes for second press.",
"linerNotes": "Second pressing, remastered lacquers.",
"assets": [
  {
    "assetId": 4419835,
    "assetType": "track",
    "discNumber": 1
  },
  {
    "assetId": 4419836,
    "assetType": "track",
    "discNumber": 1
  }
],
"explicit": false,
"releaseDate": "2026-02-14T00:00:00Z",
"historicalReleaseDate": "2025-11-10T00:00:00Z",
"upc": "843563172001",
"catalog": "NR-2026-014B",
"isPromotional": false,
"isBoxSet": false,
"isIndieExclusive": true,
"copyrightP": "2026 Northline Records",
"copyrightC": "2026 Northline Records",
"copyrightV": null,
"audioPresentationType": "vinylMaster",
"videoType": null,
"videoProductionCompanies": null,
"videoReleaseYear": null,
"videoDubbedCountryId": null,
"videoDubbedLanguageId": null,
"videoSubtitledLanguageId": null,
"videoCountryId": null,
"audioLanguageId": 1,
"labelId": 120,
"primaryMusicStyleId": 17,
"secondaryMusicStyleId": 22,
"artistId": 4402,
"metadataCountryId": 840,
"metadataLanguageId": 1,
"coverArtworkFileId": "f9af4e20-03b6-4f49-b7a8-a8d20ca8ddc2",
"additionalMedia": [
  "0f55b5b4-ea85-46a0-b778-d4b1ded47e2f"
],
"physicalReleaseConfigurationId": 2,
"originalReleaseId": null,
"tenantId": 2001,
"enterpriseId": 3001,
"creationDate": "2026-01-10T12:03:43Z",
"lastUpdateDate": "2026-02-05T10:11:00Z",
"archivedAt": null
}

Archive Physical Releases

POST /catalog/v1/physical-releases/archive

Archives physical releases in batch by asset IDs.

Request Body *

object
Batch archive request payload.
assetIds * integer[]
List of physical release asset IDs to archive.

Responses

object
id integer
succeeded boolean
code string
message string
POST /catalog/v1/physical-releases/archive 
curl -X POST "https://platform.revelator.com/catalog/v1/physical-releases/archive" -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
  "assetIds": [5001201, 5001202]
}'
Example response 200 
{
"results": [
  {
    "id": 5001201,
    "succeeded": true,
    "errors": null
  },
  {
    "id": 5001202,
    "succeeded": true,
    "errors": null
  }
]
}

Unarchive Physical Releases

POST /catalog/v1/physical-releases/unarchive

Unarchives physical releases in batch by asset IDs.

Request Body *

object
Batch unarchive request payload.
assetIds * integer[]
List of physical release asset IDs to unarchive.

Responses

object
id integer
succeeded boolean
code string
message string
POST /catalog/v1/physical-releases/unarchive 
curl -X POST "https://platform.revelator.com/catalog/v1/physical-releases/unarchive" -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
  "assetIds": [5001201, 5001202]
}'
Example response 200 
{
"results": [
  {
    "id": 5001201,
    "succeeded": true,
    "errors": null
  },
  {
    "id": 5001202,
    "succeeded": true,
    "errors": null
  }
]
}