All main assets (Albums, Tracks, Works, Videos, Products) are now available with write capabilities

This new API release is the biggest update we’ve made to our API so far.

It introduces write capabilities for all the main assets in your Reprtoir account, giving you greater control and flexibility when integrating with Reprtoir.


New endpoints


Albums (Write operations added)

  • New endpoint added: POST /api/albums
  • New endpoint added: PUT /api/albums/{uuid}
  • New endpoint added: DELETE /api/albums/{uuid}

Tracks (Write operations added)

  • New endpoint added: POST /api/tracks
  • New endpoint added: PUT /api/tracks/{uuid}
  • New endpoint added: DELETE /api/tracks/{uuid}

Works (Write operations added)

  • New endpoint added: POST /api/works
  • New endpoint added: PUT /api/works/{uuid}
  • New endpoint added: DELETE /api/works/{uuid}

Writers (New)

  • New endpoint added: GET /api/writers
  • New endpoint added: POST /api/writers/search
  • New endpoint added: GET /api/writers/{uuid}
  • New endpoint added: POST /api/writers
  • New endpoint added: PUT /api/writers/{uuid}
  • New endpoint added: DELETE /api/writers/{uuid}

Publishers (New)

  • New endpoint added: GET /api/publishers
  • New endpoint added: POST /api/publishers/search
  • New endpoint added: GET /api/publishers/{uuid}
  • New endpoint added: POST /api/publishers
  • New endpoint added: PUT /api/publishers/{uuid}
  • New endpoint added: DELETE /api/publishers/{uuid}

Videos (New)

  • New endpoint added: GET /api/videos
  • New endpoint added: POST /api/videos/search
  • New endpoint added: GET /api/videos/{uuid}
  • New endpoint added: POST /api/videos
  • New endpoint added: PUT /api/videos/{uuid}
  • New endpoint added: DELETE /api/videos/{uuid}

Products (New)

  • New endpoint added: GET /api/products
  • New endpoint added: POST /api/products/search
  • New endpoint added: GET /api/products/{uuid}
  • New endpoint added: POST /api/products
  • New endpoint added: PUT /api/products/{uuid}
  • New endpoint added: DELETE /api/products/{uuid}

Uploads (New)

  • New endpoint added: POST /api/uploads
  • New endpoint added: GET /api/uploads/{uuid}

New response fields


Album

FieldTypeDescription
exploitablebooleanWhether the album is exploitable or not.
languageobjectThe title language of the album.
notesstringThe notes of the album.
lockedbooleanWhether the album is locked or not.
artwork_filenamestringThe filename of the album artwork.
priceenumThe price category of the album. One of single, mini_ep, ep, mini_album_one, mini_album_two, budget_one, budget_two, back, mid, mid_front, front_one, front_two, front_plus, deluxe_one, deluxe_two, deluxe_three, deluxe_four.
c_linestringThe copyright (C line) of the album.
p_linestringThe production copyright (P line) of the album.

Track

FieldTypeDescription
audio_filenamestringThe filename of the audio of the track.
available_separatelybooleanWhether the track is available separately from its album or not.
languageobjectThe title language of the track.
lockedbooleanWhether the track is locked or not.
lyricsstringThe lyrics of the track.
main_recording_session_countryobjectThe main recording session country of the track.
notesstringThe notes of the track.
original_languageobjectThe original title language of the track.
original_subtitlestringThe original subtitle of the track.
positionintegerThe position of the track on its album.
volumeintegerThe volume (disc number) of the track on its album.
preview_startintegerThe start of the preview of the track, in seconds.
priceenumThe price category of the track. One of back, mid, front.
p_linestringThe P-line of the track.
recording_first_owner_countryobjectThe recording first owner country of the track.
videosarrayThe videos of the track (each with uuid and title).

Work

FieldTypeDescription
cwr_submitter_work_numberstringThe CWR submitter work number of the work.
distribution_categoryenumThe distribution category of the work. One of jazz, popular, serious, unclassified.
lockedbooleanWhether the work is locked or not.
notesstringThe notes of the work.
recorded_indicatorenumWhether the work has been recorded. One of yes, no, unknown.
version_typeenumThe version type of the work. One of original, modified.

Documentation