---
title: "List media assets"
method: GET
path: "/api/v1/workspaces/{workspace_id}/media"
tags: ["📁 Media Library"]
---

# List media assets

`GET /api/v1/workspaces/{workspace_id}/media`

Retrieve a paginated list of media assets for a workspace with filtering, search, and sort options.

## Path parameters

- `workspace_id` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `type` 'images' | 'videos'
- `search` string
- `sort` 'recent' | 'oldest' | 'size' | 'a2z' | 'z2a'

## Response `200`

Media retrieved successfully

- object
  - `status` boolean
  - `message` string
  - `current_page` integer
  - `per_page` integer
  - `total` integer
  - `last_page` integer
  - `from` integer
  - `to` integer
  - `data` object[]
    - `id` string
    - `_id` string — Deprecated alias for `id` — will be removed once clients migrate.
    - `name` string
    - `url` string
    - `mime_type` string
    - `extension` string
    - `size` integer
    - `type` 'image' | 'video' | 'gif'
    - `folder_id` string, nullable
    - `is_processing` boolean
    - `created_at` string, date-time
    - `dimensions` object
      - `width` integer, nullable
      - `height` integer, nullable

## Other responses

- `400` — Validation error
- `401` — Unauthorized - API key missing or invalid
- `429` — Too many requests

---

[API](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1.md) · [All operations](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/contentstudio/contentstudio-api-v1/revisions/ec0c85521883/schema)