Skip to main content
PUT
Set reviewer overrides on a pending staged item
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

PUT /catalog-import/items/ Description: Applies reviewer-supplied overrides to a single pending, metadata-engine-sourced staged item before it is applied. finalData is merged into the item’s existing finalData (not replaced), and only a fixed allowlist of fields is accepted — title, displayArtist, mainGenre, explicit, recordingDate, label, format, albumArt, iswc, releaseDate, version, catalogNumber; any other key is silently dropped. artists replaces the item’s artist-role map outright. This is the only way to resolve a conflict-kind diff entry, since conflicting incoming values never auto-apply. Authorization:
  • Required role: admin or higher
Method: PUT

Code Examples

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string<uuid>
required

Body

application/json

At least one of finalData or artists is required.

finalData
object

Merged (not replaced) into the item's existing finalData. Unknown keys outside the allowlist are silently dropped.

Example:
artists
object
Example:

Response

Import item updated

status
string
Example:

"success"

message
string
Example:

"Import item updated"

data
object