---
title: "Media Files"
description: "[GET] List media filesMethod: GETEndpoint: /app/api/{workspaceUuid}/media?page=1"
url: https://help.dotsimple.io/en/articles/67-media-files
collection: "API Referenz"
updated: 2026-07-03
language: en
alternates: [de]
---

# Media Files

[GET] List media filesMethod: GETEndpoint: /app/api/{workspaceUuid}/media?page=1

## \[GET\] List media files

-   Method: GET
    
-   Endpoint: https://app.dotsimple.io/app/api/_{workspaceUuid}_/media?page=1
    
-   Authorization: Bearer
    
-   Response:
    

```
{
data: [
{
id: "2",
uuid: "161b8c2d-c424-3a6a-b554-be277418ff08",
name: "tea-reduced-file-size.mp4",
mime_type: "video/mp4",
type: "video",
url: "https://app.dotsimple.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7.mp4",
thumb_url: "https://app.dotsimple.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7-thumb.jpg",
is_video: true,
created_at: "2024-03-29 15:33:32"
},
{
id: "1",
uuid: "511b8c2d-c424-3a6a-a154-be271418ff01",
name: "blue.png",
mime_type: "image/png",
type: "image",
url: "https://app.dotsimple.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi.png",
thumb_url: "https://app.dotsimple.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi-thumb.png",
is_video: false,
created_at: "2024-03-29 15:33:23"
}
],
links: {
first: "https://app.dotsimple.io/app/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/media?page=1",
last: "https://app.dotsimple.io/app/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/media?page=1",
prev: null,
next: null
},
meta: {
current_page: 1,
from: 1,
last_page: 1,
links: [
{
url: null,
label: "« Previous",
active: false
},
{
url: "https://app.dotsimple.io/app/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/media?page=1",
label: "1",
active: true
},
{
url: null,
label: "Next »",
active: false
}
],
path: "https://app.dotsimple.io/app/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/media",
per_page: 20,
to: 2,
total: 2
}
}
```

## \[GET\] Get a media file

-   Method: GET
    
-   Endpoint: https://app.dotsimple.io/app/api/_{workspaceUuid}_/media/{mediaUuid}
    
-   Authorization: Bearer
    
-   Response:
    

```
{
id: "1",
uuid: "511b8c2d-c424-3a6a-a154-be271418ff01",
name: "blue.png",
mime_type: "image/png",
type: "image",
url: "https://app.dotsimple.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi.png",
thumb_url: "https://app.dotsimple.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi-thumb.png",
is_video: false,
created_at: "2024-03-29 15:33:23"
}
```

## \[POST\] Upload a media file

-   Method: POST
    
-   Endpoint: https://app.dotsimple.io/app/api/_{workspaceUuid}_/media
    
-   Authorization: Bearer
    
-   Body:
    

```
{
  "file": binary,
}
```

-   **Key**
    
    -   file
        
-   **Format**
    
    -   binary
        
-   **Required**
    
    -   required
        
-   **Description**
    
    -   File binary.
        
    
    ## \[DEL\] Delete media files
    
    -   Method: DELETE
        
    -   Endpoint: https://app.dotsimple.io/app/api/_{workspaceUuid}_/media
        
    -   Authorization: Bearer
        
    -   Params:
        
    
    ```
    {
      "items": [1,2]
    }
    ```
    
    -   **Key**
        
        -   items
            
    -   **Format**
        
        -   array
            
    -   **Required**
        
        -   required
            
    -   **Description**
        
        -   Array of media file IDs
            
        
        **Key**
        
        -   items.\*
            
    -   **Format**
        
        -   integer
            
    -   **Required**
        
        -   required
            
    -   **Description**
        
        -   Media File ID