Skip to main content

​
Endpoint

GET /v1/media
Authorization: Bearer sk_live_...

​
Query Parameters

ParamTypeDefaultDescription
categorystringFilter: photo, video, audio, document
limitnumber50Max results (capped at 100)
offsetnumber0Pagination offset

​
Example

# List all media
curl "$API/v1/media" -H "Authorization: Bearer $API_KEY"

# List only photos
curl "$API/v1/media?category=photo&limit=20" -H "Authorization: Bearer $API_KEY"

​
Response (200)

{
  "media": [
    {
      "id": "3449d148-5cc5-4bcc-9e02-242398025dc2",
      "category": "photo",
      "filename": "photo.jpg",
      "mimeType": "image/jpeg",
      "sizeBytes": 45000,
      "title": "Profile Photo",
      "pinned": false,
      "expiresAt": "2026-06-22T00:00:00Z",
      "createdAt": "2026-03-24T00:00:00Z"
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0
}