---
title: "List media assets"
method: GET
path: "/media/{workspaceId}/assets"
tags: ["Media library"]
---

# List media assets

`GET /media/{workspaceId}/assets`

## Request

- Base URL: `https://api.dynapictures.com`
- URL: `https://api.dynapictures.com/media/{workspaceId}/assets`
- Auth: HTTP bearer

Lists the images and folders of a workspace, 30 per page.

## Path parameters

- `workspaceId` string, required

## Query parameters

- `p` integer

## Response `200`

One page of assets.

- MediaAssetPage
  - `page` integer, required: The current page, starting at 1.
  - `totalPages` integer, required: The total number of pages. A page holds 30 assets.
  - `results` MediaAsset[], required: The assets on this page.
    - `id` string, required: The ID of the asset.
    - `folder` boolean: Whether this asset is a folder rather than an image.
    - `mimeType` string: The MIME type of the image.
    - `filename` string: The file name.
    - `animated` boolean: Whether the image is animated.
    - `size` integer: The size in bytes.
    - `url` string, uri: URL of the image.
    - `thumbnailUrl` string, uri: URL of the thumbnail.
    - `dateCreated` string, date-time: When the asset was created.
    - `dateUpdated` string, date-time: When the asset was last changed.

## Other responses

- `400`: The request is invalid. `message` says why.
- `401`: The API key is missing or wrong.
- `403`: The plan limit is reached, the trial has expired, or the key has no access to this resource.
- `404`: The resource does not exist, or the key has no access to it.

---

[API](https://skmtc.dev/dynapictures/apis/dynapictures-api.md) - [All operations](https://skmtc.dev/dynapictures/apis/dynapictures-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dynapictures/apis/dynapictures-api/revisions/a9820777cfb3?raw)