v1

latestOpenAPI 3.1.02026-07-13305453.8 KB

Media

List media assets

Retrieve media assets for the authenticated workspace.

get/v1/media

Query parameters

limitinteger

Number of items per page (1-100)

pageinteger

Page number

querystring

Search media by name, alt text, URL, or MIME type

Example:hero

Search media by name, alt text, URL, or MIME type

type'image' | 'video' | 'audio' | 'document'

Filter by inferred media type

Example:image

Filter by inferred media type

order'asc' | 'desc'

Sort order by creation date

Example:desc

Sort order by creation date

Response

Media assets retrieved successfully

Example response

{
  "media": [
    {
      "id": "cryitfjp1234jl04vdnycek8",
      "name": "Hero image",
      "url": "https://cdn.marblecms.com/media/hero.jpg",
      "alt": "A dashboard screenshot",
      "size": 382019,
      "mimeType": "image/jpeg",
      "width": 1600,
      "height": 900,
      "duration": 12000,
      "blurHash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
      "createdAt": "2024-01-15T10:00:00Z",
      "updatedAt": "2024-01-16T12:00:00Z"
    }
  ],
  "pagination": {
    "limit": 10,
    "currentPage": 1,
    "nextPage": 2,
    "totalPages": 5,
    "totalItems": 42
  }
}