Skip to main content
POST
Link a work to a recording
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

POST /work//recordings/ Description: Creates a WorkRecording junction row linking a composition (CWRWork) to a master recording (Asset). 404 if either side doesn’t belong to the tenant; 400 if the link already exists. Response is the work’s full recordings list (not just the created link) so the FE can refresh in one round trip. Authorization:
  • Required role: admin or higher
Method: POST

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

workId
string<uuid>
required
assetId
string<uuid>
required

Body

application/json

All fields optional — defaults to sharePercentage=100, role=original, isPrimary=true. 400 if the work↔recording link already exists.

sharePercentage
number
Required range: 0 <= x <= 100
role
enum<string>
Available options:
original,
sample,
cover,
remix,
arrangement
isPrimary
boolean
notes
string

Response

Recording linked

Shape returned by link/unlink/list work-recordings endpoints.

work
object
recordings
object[]