Media Metadata API

Authentication

All requests require a Bearer token in the Authorization header. The token is matched against the apiToken field of the User entity.

Usage

curl -H "Authorization: Bearer your-secret-token" https://example.com/api/media/photo.jpg

Endpoints

GET /api/media/{filename}

Returns metadata for the given media file. Supports current filename and historical filenames (after renames).

Response:

{
  "filename": "photo.jpg",
  "mimeType": "image/jpeg",
  "size": 204800,
  "alt": "A mountain view",
  "alts": { "fr": "Une vue de montagne" },
  "tags": ["landscape", "nature"],
  "image": {
    "width": 1920,
    "height": 1080,
    "ratio": 1.778,
    "ratioLabel": "16:9",
    "mainColor": "#3a6ea8"
  }
}

The image key is null for non-image media (PDF, video, etc.).

POST /api/media/{filename}

Partial update — only the fields you send are modified.

Updatable fields (all optional):

Example:

curl -X POST \
  -H "Authorization: Bearer your-secret-token" \
  -H "Content-Type: application/json" \
  -d '{"alt": "New alt text", "tags": ["landscape"]}' \
  https://example.com/api/media/photo.jpg

Returns the full updated metadata (same format as GET).

Error Responses