JsonCutDocs
V2 APIEndpointsMedia

Upload a media file

Upload a media file. Owned image, video, audio and font resources referenced by durable jsoncut-media URLs. Required API key scopes: `media:write`.

POST
/api/v2/media

Authorization

apiKeyAuth

Request Body

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v2/media" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "kind": "image",    "mimeType": "string",    "sizeBytes": 1,    "source": "string"  }'
{  "success": true,  "data": {    "id": "media_01J",    "name": "product-shot.png",    "kind": "image",    "mimeType": "image/png",    "sizeBytes": 184320,    "source": "https://api.jsoncut.com/api/v2/media/media_01J/content?token=short-lived",    "reference": "jsoncut-media://media_01J",    "retention": "project",    "createdAt": "2026-08-25T09:10:00.000Z",    "width": 1600,    "height": 900  }}

List uploaded media GET

List uploaded media. Owned image, video, audio and font resources referenced by durable jsoncut-media URLs. Required API key scopes: `media:read`.

Import and pin a public media URL POST

Import and pin a public media URL. Owned image, video, audio and font resources referenced by durable jsoncut-media URLs. Required API key scopes: `media:write`.