Release Notes

Release notes

All changes to the Revelator API are tracked and documented here.

June 24th 2024


New Monetization Policy changes introduced to reflect TikTok’s Monetization Changes

What’s new:

  • Added monetization policies for TikTok. (NoTikTokScanning, Monetize, BlockAccess)
  • A new field trackMonetizationPolicyIds available during Setting Distribution Options for track-level policies.

What changed:

June 20th 2024


Implementation deadline - July 15th

Failure to implement these changes by the deadline specified will cause your pretrack creation and distribution workflow to fail

  • Both new and existing tracks must contain the new fields (with a non-0 value) before they can be distributed
  • /distribution/release/{releaseId}/validate and /distribution/release/addtoqueue will error if trackType or trackProperties are 0 (previously null)

New fields/changes introduced to reflect TikTok’s Monetization Changes

What’s new:

  • trackProperties is a new and required field on the Track Object.

What changed:

  • trackType is now a required field on the Track Object.
    • This field accepts a new value: 2 - Cover song

May 22nd 2024


What changed:

  • POST /distribution/release/addtoqueue will now fail if it contains stores with isActive == false

May 15th 2024


What’s new:

What changed:

  • Tracks that are less than 2 seconds long are no longer allowed for distribution.
    • For new files all media/audio/... endpoints are updated to reflect this change.
    • For old files /distribution/release/{releaseid}/validate was updated to reflect this change.
  • Composer/Writer details on tracks missing either a valid first and last artist name are no longer allowed for distribution.
    • Endpoint /distribution/release/{releaseid}/validate was updated to reflect this change.

April 12th 2024


What’s new:

  • Added a Glossary page containing most used terms.

April 1st 2024


What’s new:

March 20th 2024


What changed:

  • Distribution statuses updated.
    • New statuses for takedowns (72, 75, 76, 79)
    • Old statuses updated (8, 10, 11)

March 13th 2024


What’s new:

  • Added the examples back.

January 29th 2024


What’s new:

  • Tipalti integration added to Revelator. By completing the following flows you will be able to pay your payees using this feature:
    • Payor Flow - Connect your Tipalti Account with your Revelator Parent Account
    • Payee Flow - Set up a payee to receive money via Tipalty

January 24th 2024


What’s new:

New API Documentation published 🥳

November 11th 2023


What’s new:

  • Newly documented endpoints for uploading files
    • POST /media/audio/upload/wav - Upload a file in wav format to the Revelator servers
    • POST /media/image/upload - Upload an image file to the Revelator servers
    • POST /media/audio/pullexternal/wav - Pull a file in wav format from an external url to the Revalator servers

Deprecated:

  • Using an externalUrl to associate files with a track/release is no longer recommended! Files referenced like this are not being downloaded by our system until distribution, leading to unexpected behavior. Use the endpoints mentioned above for all file uploading needs.

September 26th 2023


What’s new:

  • Enterprise information endpoints:
    • GET /enterprise/clients/{id} - Retrieves basic information about a single enterprise
    • GET /enterprise/clients/all - Retrieves basic information about all enterprises associated with the account

Deprecated:

  • POST /account/createnewaccount' - endpoint is now deprecated. This is done to mitigate confusion for creating new accounts.