Update a work

put

https://reprtoir.io/api/works/{uuid}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

uuid

string

required

The UUID of the resource to retrieve.

Body Params

administrator_publisher_uuids

array of strings

The Administrators of the work.

administrator_publisher_uuids

alternative_titles

array of objects

The alternative titles of the work.

alternative_titles

arranger_writer_uuids

array of strings

The Arrangers of the work.

arranger_writer_uuids

author_writer_uuids

array of strings

The Authors of the work.

author_writer_uuids

catalog_uuid

string

required

The UUID of the catalog the work belongs to.

co_publisher_uuids

array of strings

The Co-Publishers of the work.

co_publisher_uuids

composer_writer_uuids

array of strings

The Composers of the work.

composer_writer_uuids

contains_public_domain

boolean

Whether the work contains public domain material or not.

contains_samples

boolean

Whether the work contains samples or not.

creation_year

integer

The creation year of the work.

cwr_submitter_work_number

string

The CWR submitter work number of the work.

description

string

The description of the work.

distribution_category

string

enum

The distribution category of the work.

Allowed:

duration

integer

The duration of the work, in seconds.

exploitable

boolean

Whether the work is exploitable or not.

identifiers

object

The identifiers of the work.

iswc

string

The ISWC of the work.

language_code

string

enum

The ISO code of the title language of the work.

locked

boolean

Defaults to false

Whether the work is locked or not.

lyric_adaptation_type

string

enum

The CWR lyric adaptation type of the work.

lyrics

string

The lyrics of the work.

music_arrangement_type

string

enum

The CWR music arrangement type of the work.

Allowed:

notes

string

The notes of the work.

original_publisher_uuids

array of strings

The Original Publishers of the work.

original_publisher_uuids

ownership_rights

array of objects

The ownership and collection rights splits of the work. Sent as a flat list of root splits, each one optionally carrying its sub-splits in children.

ownership_rights

ownership_share

integer

The ownership or collection share of the work.

recorded_indicator

string

enum

Whether the work has been recorded.

Allowed:

ref

string

The internal reference of the work.

sub_publisher_uuids

array of strings

The Sub-Publishers of the work.

sub_publisher_uuids

tag_uuids

array of strings

The UUIDs of the tags of the work.

tag_uuids

territory_rights

array of objects

The territory-based collection rights splits of the work. Sent as a list of blocks, each one targeting a set of CWR territories and carrying a flat list of root splits (each one optionally carrying its sub-splits in children). The level and position of each split are computed automatically.

territory_rights

title

string

required

The title of the work.

track_uuids

array of strings

The UUIDs of the tracks of the work.

track_uuids

version_type

string

enum

The version type of the work.

Allowed:

worldwide_collection_territories

object

The Worldwide collection territories of the work.

Headers

X-API-Version

string

Defaults to 2026-06-29

Determines the date-based API version of your API call. If none is provided, the API version associated to your API key will be used.

Responses

200The work has been updated.

404The work could not be found.

422The work could not be updated.