Approve Enrichment Items - Royalti.io API

curl --request POST \
  --url https://api.royalti.io/checklist/enrichment/approve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "itemIds": [
    "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "b2c3d4e5-f6a7-8901-2345-678901bcdef0"
  ]
}
'

{
  "status": "success",
  "message": "Imported 10, failed 0",
  "data": {
    "imported": 123,
    "failed": 123
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      "<string>"
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      "<string>"
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      "<string>"
    ]
  }
}

POST

checklist

enrichment

approve

curl --request POST \
  --url https://api.royalti.io/checklist/enrichment/approve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "itemIds": [
    "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "b2c3d4e5-f6a7-8901-2345-678901bcdef0"
  ]
}
'

{
  "status": "success",
  "message": "Imported 10, failed 0",
  "data": {
    "imported": 123,
    "failed": 123
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      "<string>"
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      "<string>"
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      "<string>"
    ]
  }
}

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

Description

/checklist/enrichment/approve Approves enrichment items and executes the create/update operations on the catalog. For action: create items, new assets or products are created using the field resolution priority chain: finalData > enriched fields > raw fields > defaults. For action: update items, only empty fields on the existing record are filled with enriched values, unless the admin has explicitly set overrides in finalData. Items can be selected by explicit itemIds or by batchId (optionally filtered by type). Authorization:

Required role: admin or higher

Method: POST

Code Examples

const response = await fetch('https://api.royalti.io/checklist/enrichment/approve', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "itemIds": [
      {}
    ],
    "batchId": "sample-batchId",
    "type": "sample-type"
  })
});

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

import requests

response = requests.post(
  'https://api.royalti.io/checklist/enrichment/approve',
  headers={
    'Authorization': f'Bearer {token}'
  },
  json={"itemIds":[{}],"batchId":"sample-batchId","type":"sample-type"}
)

data = response.json()
print(data)

curl -X POST https://api.royalti.io/checklist/enrichment/approve \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"itemIds":[{}],"batchId":"sample-batchId","type":"sample-type"}'

Authorizations

Authorization

string

header

required

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

Body

application/json

itemIds

string<uuid>[]

Specific item IDs to approve

batchId

string

Approve all pending items in this batch (used when itemIds not provided)

type

enum<string>

Optional type filter when using batchId

Available options:

asset,

product

Response

Items approved and imported

status

string

Example:

"success"

message

string

Example:

"Imported 10, failed 0"

data

object

Show child attributes

​Description

​Code Examples

Authorizations

Body

Response

Description

Code Examples