---
title: "List contents of a media directory."
method: GET
path: "/api/media"
tags: ["Media"]
---

# List contents of a media directory.

`GET /api/media`

## Query parameters

- `path` string

## Response `200`

Directory listing

- ListMediaResponse — Response containing a directory listing.
  - `current_path` string, required — Current directory path (relative to media root)
  - `entries` MediaFileEntry[], required — Directory contents
    - `is_directory` boolean, required — Whether this is a directory
    - `mime_type` string, nullable — MIME type (None for directories)
    - `modified` integer, required — Last modified timestamp (UNIX epoch seconds)
    - `name` string, required — File or directory name
    - `path` string, required — Full path relative to media root
    - `size` integer, required — File size in bytes (0 for directories)
  - `parent_path` string, nullable — Parent directory path (None if at root)

## Other responses

- `400` — Invalid path
- `404` — Directory not found

---

[API](https://skmtc.net/eyevinn/apis/strom-api.md) · [All operations](https://skmtc.net/eyevinn/apis/strom-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eyevinn/strom-api/versions/c96558b86012/schema)