NDNCI Docs
API v1API reference

Create a download URL

Retrieve a temporary authorized download URL for one workspace media item. Treat the URL as a secret until it expires.

GET/v1/media/{mediaId}/download

Authorization

bearerKey
AuthorizationBearer <token>

A scoped automation key authorized for the REST API.

In: header

Path Parameters

mediaId*string
Formatuuid

Header Parameters

X-Ndnci-Workspace*string

Select a workspace explicitly included in this access grant.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/media/497f6eca-6276-4993-bfeb-53cbbbba6f08/download" \  -H "X-Ndnci-Workspace: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Authorization: Bearer <NDNCI_API_KEY>"
{  "success": true,  "code": "PUBLIC_MEDIA_DOWNLOAD",  "message": "Successful response",  "data": {    "url": "https://media.example.org/signed-download",    "expiresAt": "2026-10-01T12:30:00Z"  }}

Required scope: media:read · Usage points: 2

Credits are charged separately for work that consumes paid services.

Upload workspace media POST

Upload a file through the workspace's normal type, size and storage quota checks. This API grants no direct media deletion operation.

Follow job updates GET

Receive bounded server-sent job updates for one authorized workspace job. Available with Pro; reconnect and read the job when an event gap is detected.