Atlas CMS
API Reference

Media

GET
/api/v1/public/media/{id}

Returns metadata for a media file: URL, dimensions (width, height), MIME type, file size, and alt text. Requires an X-API-Key header — the key identifies the workspace the media belongs to.

Authorization

ApiKeyAuth
X-API-Key<token>

API key from the Atlas dashboard (Settings → API Keys).

In: header

Path Parameters

id*string

Media ID

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/public/media/string"
{  "message": "Success",  "meta": null,  "success": true,  "data": {    "alt_text": "A beautiful sunset",    "focal_x": 0.5,    "focal_y": 0.5,    "height": 1080,    "id": "019078e2-0000-7000-8000-000000000000",    "mime_type": "image/png",    "url": "https://cdn.atlas.io/media/2026/06/abc123-photo.png",    "width": 1920  }}
{  "code": "VALIDATION_FAILED",  "data": null,  "errors": null,  "message": "Validation failed",  "meta": null,  "success": false,  "traceId": "req_a1b2c3d4"}
{  "code": "VALIDATION_FAILED",  "data": null,  "errors": null,  "message": "Validation failed",  "meta": null,  "success": false,  "traceId": "req_a1b2c3d4"}