---
title: "List media uploads"
method: GET
path: "/media"
tags: ["Media"]
---

# List media uploads

`GET /media`

Returns media uploads for a workspace with pagination.

## Query parameters

- `workspaceId` string, required
- `offset` integer
- `limit` integer

## Response `200`

List of media uploads with pagination

- object
  - `data` object[], required
    - `id` string, required
    - `workspaceId` string, required
    - `type` 'image' | 'video' | 'gif', required
    - `name` string, required
    - `url` string, uri, nullable, required
    - `thumbnailUrl` string, uri, nullable, required
    - `width` number, nullable, required
    - `height` number, nullable, required
    - `size` number, required
    - `mimeType` string, required
    - `status` 'uploading' | 'processing' | 'error' | 'success', required
    - `createdAt` string, date-time, required
  - `pagination` object, required
    - `offset` number, required
    - `limit` number, required
    - `hasMore` boolean, required

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/planable/apis/planable-public-api.md) · [All operations](https://skmtc.net/planable/apis/planable-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/planable/planable-public-api/revisions/e91a4f756dfe/schema)