Queue a distribution run

Queues a distribution run for the linked user. Provide exactly one of collectionRef or resourceRefs:

• collectionRef — distribute an existing collection (project). The collection must be visible to the linked user.
• resourceRefs — distribute an ad-hoc set of resources. A collection is created to hold them (the queue distributes collections), then queued. Resources the linked user cannot see are dropped; if none remain, the call returns 404.

Not-found and no-access both collapse to 404 so the surface can't be used to probe refs in other usergroups. Requires the write scope and the linked user's dm (distribution management) permission.

Idempotency

Pass an Idempotency-Key header (a unique random string per logical queue, e.g. a UUID) to make retries safe. The first successful response with a given key is cached for 24 hours; replays return the same body byte-for-byte with Idempotent-Replayed: true. Reusing the key with a different request body returns 422 IDEMPOTENCY_KEY_CONFLICT.

Header Parameters

Response Body

curl -X POST "https://example.com/distribution/queue" \  -H "Content-Type: application/json" \  -d '{    "destinationRef": 7,    "collectionRef": 300  }'

{  "success": true,  "status": "success",  "message": "Distribution run queued",  "data": {    "queueRef": 555,    "status": 0,    "statusLabel": "pending",    "destinationRef": 7  }}

{  "success": false,  "status": "fail",  "message": "string",  "error": {    "message": "API key is required",    "code": "NO_API_KEY"  }}

{  "success": false,  "status": "fail",  "message": "API key is required",  "error": {    "code": "NO_API_KEY",    "message": "API key is required"  }}

{  "success": false,  "status": "fail",  "message": "This API key does not have the 'write' scope",  "error": {    "code": "INSUFFICIENT_SCOPE",    "message": "This API key does not have the 'write' scope"  }}

{  "success": false,  "status": "fail",  "message": "string",  "error": {    "message": "API key is required",    "code": "NO_API_KEY"  }}

{  "success": false,  "status": "fail",  "message": "string",  "error": {    "message": "API key is required",    "code": "NO_API_KEY"  }}