Reject staged items - Royalti.io API

curl --request POST \
  --url https://api.royalti.io/catalog-import/reject \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "batchId": "metadata-import-8f14e45f-ceea-4d5e-8b3a-0a1b2c3d4e5f"
}
'

{
  "status": "success",
  "message": "Rejected 3 item(s)",
  "data": {
    "rejected": 123
  }
}

{
  "status": "error",
  "message": "Provide batchId or itemIds[] to reject"
}

{
  "status": "error",
  "message": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "status": "error",
  "message": "Insufficient permissions. Admin access required."
}

{
  "status": "error",
  "message": "Internal server error"
}

POST

catalog-import

reject

curl --request POST \
  --url https://api.royalti.io/catalog-import/reject \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "batchId": "metadata-import-8f14e45f-ceea-4d5e-8b3a-0a1b2c3d4e5f"
}
'

{
  "status": "success",
  "message": "Rejected 3 item(s)",
  "data": {
    "rejected": 123
  }
}

{
  "status": "error",
  "message": "Provide batchId or itemIds[] to reject"
}

{
  "status": "error",
  "message": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "status": "error",
  "message": "Insufficient permissions. Admin access required."
}

{
  "status": "error",
  "message": "Internal server error"
}

This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

POST /catalog-import/reject Description: Marks the pending, metadata-engine-sourced staged items matching batchId and/or itemIds (scoped to the caller’s tenant) as rejected, stamping reviewedBy/reviewedAt. Rejected rows are never applied. Rejecting is not permanent for the underlying identifier — a later import that proposes the same ISRC/UPC re-stages it as a fresh row rather than being deduplicated away. Authorization:

Required role: admin or higher

Method: POST

Code Examples

const response = await fetch('https://api.royalti.io/catalog-import/reject', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "ref": "#/components/schemas/ApplyOrRejectRequest"
  })
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
  'https://api.royalti.io/catalog-import/reject',
  headers={
    'Authorization': f'Bearer {token}'
  },
  json={"ref":"#/components/schemas/ApplyOrRejectRequest"}
)

data = response.json()
print(data)

curl -X POST https://api.royalti.io/catalog-import/reject \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ref":"#/components/schemas/ApplyOrRejectRequest"}'

Authorizations

Authorization

string

header

required

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

Body

application/json

One of batchId or a non-empty itemIds array is required. Only rows with status pending and belonging to the caller's tenant are affected.

batchId

string

Example:

"metadata-import-8f14e45f-ceea-4d5e-8b3a-0a1b2c3d4e5f"

itemIds

string<uuid>[]

Response

Items rejected

status

string

Example:

"success"

message

string

Example:

"Rejected 3 item(s)"

data

object

Show child attributes

​Description

​Code Examples

Authorizations

Body

Response

Description

Code Examples