Skip to main content
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