API v1API reference
Upload workspace media
Upload a file through the workspace's normal type, size and storage quota checks. This API grants no direct media deletion operation.
POST
/v1/media/uploadAuthorization
bearerKey AuthorizationBearer <token>
A scoped automation key authorized for the REST API.
In: header
Header Parameters
X-Ndnci-Workspace*string
Select a workspace explicitly included in this access grant.
Format
uuidRequest Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/media/upload" \ -H "X-Ndnci-Workspace: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Authorization: Bearer <NDNCI_API_KEY>" \ -F file="string"{ "success": true, "code": "PUBLIC_MEDIA_UPLOAD", "message": "Successful response", "data": { "id": "123e4567-e89b-42d3-a456-426614174005", "workspaceId": "123e4567-e89b-42d3-a456-426614174001", "name": "sample.png", "mimeType": "image/png", "sizeBytes": 4096, "createdAt": "2026-10-01T12:00:00Z", "downloadUrl": null }}Required scope: media:write · Usage points: 10
Credits are charged separately for work that consumes paid services.