Promote (finalize) validation data into the data mart

Promotes validation data at any granularity. Supply at least one selector: { all: true } (whole project), { documentIds: [...] } (all subtopics of those documents), or { documentDataGroups: [{ documentId, dataGroupId }] } (explicit pairs). If you supply more than one they are NOT combined — a fixed precedence applies and the rest are silently ignored: all wins over documentDataGroups, which wins over documentIds. Each promoted document↔data-group is copied into the data mart and marked COMPLETED. Explicit pairs not in the project are reported as not_found.

Requires an API key with one of these roles: admin, editor.

Path Parameters

Response Body

curl -X POST "https://example.com/extractions/497f6eca-6276-4993-bfeb-53cbbbba6f08/promote" \  -H "Content-Type: application/json" \  -d '{}'

{  "data": {    "promotedCount": 0,    "totalPointsPromoted": 0,    "results": [      {        "documentId": "4704590c-004e-410d-adf7-acb7ca0a7052",        "dataGroupId": "8488a14d-7eb2-49b5-ad00-46d2c399fd09",        "status": "promoted",        "pointsPromoted": 0      }    ]  },  "meta": {    "requestId": "string",    "timestamp": "string"  }}