Skip to main content
POST
Execute a DMP import
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

POST /dmp/import/execute Description: Same file inputs as /dmp/import/preview, but actually creates entities inside a single database transaction, run phase by phase: writers → works → work-writer relationships → artists → recordings (creates Assets + WorkRecordings) → cross-references (creates WorkRegistrations) → acknowledgements. The transaction commits even when individual records error — per-record failures are collected in each phase’s errors[], not thrown — so check result.*.errors rather than relying on a 200 status alone. A 200 with a non-zero error count still returns message describing the error count and what was created. Authorization:
  • Required role: admin or higher
Method: POST

Code Examples

Authorizations

Authorization
string
header
required

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

Body

multipart/form-data
worksFile
file
required

DMP works JSON export: { "works": [...] }.

acknowledgementsFile
file

Optional DMP acknowledgements CSV export.

Response

Import run completed (see result.*.errors for any per-record failures — the transaction still commits)

message
string
Example:

"DMP import completed successfully"

result
object