API ReferenceMedia
Import media from a URL
Downloads the file at the given public URL into workspace storage. Plan quotas (file size, storage, monthly uploads) apply. Thumbnails are generated asynchronously.
Authorization
api-key AuthorizationBearer <token>
Workspace API key (nim_live_...)
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/v1/media" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/images/launch-banner.png" }'{ "id": "123e4567-e89b-12d3-a456-426614174000", "name": "launch-banner.png", "type": "IMAGE", "url": "string", "thumbnailUrl": {}, "size": 245760, "createdAt": "2026-07-05T10:00:00.000Z"}Empty