GET /get-/media — FlowCMS API Reference

Request Example

cURL

JavaScript

Python

curl -X GET "https://api.flowcms.io/v1/get-/media?limit=20&sort=-createdAt" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

const response = await fetch('https://api.flowcms.io/v1/get-/media?limit=20&sort=-createdAt', {
  headers: {
    'Authorization': `Bearer ${process.env.FLOWCMS_API_KEY}`,
    'Content-Type': 'application/json'
  }
});

const { data, meta } = await response.json();
console.log(data);

import requests

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

params = {"limit": 20, "sort": "-createdAt"}
response = requests.get("https://api.flowcms.io/v1/get-/media", headers=headers, params=params)

print(response.json())

Query Parameters

Parameter	Type	Required	Description
page	integer	Optional	Pagination page number. Defaults to `1`.
limit	integer	Optional	Number of items per page. Max `100`. Defaults to `20`.
sort	string	Optional	Sort field. Prefix with `-` for descending. E.g., `-createdAt`, `name`.
type	string	Optional	Filter by MIME type prefix. E.g., `image`, `video`, `document`.
tags	string	Optional	Comma-separated list of tags. E.g., `hero,brand,2024`.
fields	string	Optional	Comma-separated fields to include in response. Reduces payload size.

Response

200 OK application/json

{
  "data": [
    {
      "id": "med_8f3a29c1b4",
      "name": "hero-banner-final.png",
      "url": "https://cdn.flowcms.io/v1/assets/med_8f3a29c1b4",
      "type": "image/png",
      "size": 1245830,
      "dimensions": { "width": 1920, "height": 1080 },
      "tags": ["hero", "marketing", "q3"],
      "createdAt": "2025-03-12T14:22:00Z",
      "updatedAt": "2025-03-12T14:22:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 142,
    "totalPages": 8
  }
}

💡

Optimizing Payloads

Use the fields parameter to request only the properties you need. This significantly reduces bandwidth and improves response times for large asset libraries.

Visual Preview

This is how the API response typically renders in a frontend asset manager or gallery component:

🖼️

hero-banner-final.png

1.24 MB1920×1080

🎥

product-demo-v2.mp4

24.8 MB02:14

📄

brand-guidelines.pdf

4.2 MB12 pages

🎨

icon-set-pack.svg

0.85 MB24 icons

Notes & Limits

Media URLs are signed by default if your workspace has security policies enabled. Tokens expire after 24 hours.
Video assets over 500MB return a proxy URL that streams via our edge CDN.
Rate limit: 120 requests/minute for this endpoint.

⚠️

Path Syntax Note

The /get-/media route is a reserved internal alias for legacy compatibility. New integrations should use /v1/media or /v1/assets.

Retrieve Media Assets