Upload native DDEX message

Accept a native ERN message for secure parsing and immutable preservation before validation, relay, export, or create-only import.

Authorization

BearerAuth

AuthorizationBearer <token>

In: header

Header Parameters

Idempotency-Key*string

Unique request key. Reuse with the same body replays the result; reuse with a different body returns a conflict.

Length8 <= length <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

connection_reference?string

Versioned partner connection to use.

Formatuuid

release_reference*string

SpaceMedia release to snapshot and package.

Formatuuid

native_xml?string

Native ERN XML up to 25 MiB, preserved byte-for-byte by the gateway.

Lengthlength <= 26214400

deal_profile_reference?string

Explicit commercial deal profile for this operation.

Formatuuid

action?string

Requested DDEX lifecycle action.

Value in

"insert"
"update"
"territorial_takedown"
"global_takedown"
"purge"

metadata_overlay?

Versioned DDEX-only metadata that is absent from the release model.

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/ddex/uploads" \  -H "Idempotency-Key: stringst" \  -H "Content-Type: application/json" \  -d '{    "connection_reference": "3779bd9d-53b8-4244-b9ef-2467ae8dd499",    "action": "insert"  }'

{  "data": {    "reference": "45be9e79-f39e-4cf9-bfc8-bf9f10481da6",    "status": "ready",    "review_status": "not_required",    "transport_status": "not_started",    "partner_status": "not_started",    "findings": []  },  "status_url": "/api/v1/ddex/messages/45be9e79-f39e-4cf9-bfc8-bf9f10481da6",  "correlation_key": "ddex_01J2M4Y8Q7K3"}

Authorization

Header Parameters

Request Body

Response Body

202application/json

401application/json

403application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`