API v1API reference
Read media metadata
Retrieve one media item belonging to the selected workspace.
GET
/v1/media/{mediaId}Authorization
bearerKey AuthorizationBearer <token>
A scoped automation key authorized for the REST API.
In: header
Path Parameters
mediaId*string
Format
uuidHeader Parameters
X-Ndnci-Workspace*string
Select a workspace explicitly included in this access grant.
Format
uuidResponse 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" \ -H "X-Ndnci-Workspace: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Authorization: Bearer <NDNCI_API_KEY>"{ "success": true, "code": "PUBLIC_MEDIA_GET", "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:read · Usage points: 1
Credits are charged separately for work that consumes paid services.