Add a version to an entity
POST/api/v1/musiccompanion/entities/:id/versions
Adds a version (a radio edit, a full-length mix, a station intro, new artwork) either from an asset uploaded with POST /api/v1/musiccompanion/assets or from a new upload. With an upload source the response carries the signed target: PUT the file there, then confirm it with POST /api/v1/musiccompanion/assets/{id}/confirm. The first version of a kind becomes primary; pass isPrimary to replace the current primary. Attaching an ONLINE audio asset queues any automatic analyses enabled on the entity type.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 422
- 429
- 500
The created version, with an upload target when requested.
Invalid request.
Missing or invalid bearer token.
The token lacks the required permission.
Entity or asset not found.
The asset is already a version of this entity (version_exists).
The asset type does not match the requested kind (asset_kind_mismatch) or the upload MIME type does not (unsupported_media_type).
Rate limit exceeded. Retry after the period in the Retry-After header.
Unexpected server error.