💾Deprecations

2024-02-12

Changing ImportTask relationships

Historically, import tasks were required to be associated with a product and could optionally be linked to a track or video for ingesting track audio or video master files.

To enhance flexibility and support new media types, we are changing how import tasks relate to objects:

What's changing

Starting on 2025-08-12, import tasks will be exclusively linked to a polymorphic object called "attachable". This object can can represent a product, track, video, or an "asset attachment" – a new type specifically for Apple Motion Art.

What you have to do

Refer to the updated ImportTask resource page for implementation details. The current ImportTask method will no longer be supported after 2025-08-12.

2023-01-26

Refactoring of data URI for binary files

The Labelcamp API allows binary data to be sent in data uri format on some attributes. Although we prefer other scenarios (bucket authorization or URL download) for large files, this method is allowed and sometimes the only way to update some resources.

Starting 2023-02-26 we will improve this upload mode by strictly implementing the data uri specification defined here: https://www.rfc-editor.org/rfc/rfc2397

Before this, we have been quite liberal about sending the mime type and allowed its absence in some cases by applying a default mime type (we assumed for example that an image was image/jpg in the absence of information).

For compliance and consistency purposes, it will now be mandatory to specify the data mime type on the client side in the form: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA

The attributes affected by this change are:

2021-11-10

Refactoring of product booklets

Starting 2022-02-10, the create method available on the booklet resource will be removed and replaced by the booklet attribute of the product resource.

Why

This change will allow us to enhance storage of assets and ease the API integration of new customers.

What you have to do

Instead of creating a booklet resource associated with your product, and associating a file to it, you only have to add the booklet directly to the product resource

2020-12-11

📀Refactoring of product status

Starting 2021-03-11, we'll change product status in the v2 API.

What's changing

The old product statuses :

  • is-active

  • content-validation

  • label-validation

Will be replaced by these new ones :

  • draft

  • reviewing

  • active

  • archived

Why

This change allows a better flow for distributors whose teams that validate submissions are not the ones that submit albums.

What you have to do

You have to change your calls on /api/v2/products, please refer to Create Product

📽️ Refactoring of TrackVideo

Starting 2021-03-11, we'll change product status in the v2 API.

What's changing

The link between Retails and Videos will be replaced by a link between Dsps and Videos

Why

This change makes it possible to specify a specific video for a dsp, not just a retailer. Most users used to use this property to specify a video for Apple Music, but forgot to do it for iTunes. Now you just need to link a video to the Apple DSP to make it available on both retailers.

What you have to do

Change your relationship from retail to dsp. Please refer to Create TrackVideo

PreviousChangelogNextResources

Last updated