---
title: "List the user's ready files, optionally filtered by zone"
method: GET
path: "/agents/files"
tags: ["Files"]
---

# List the user's ready files, optionally filtered by zone

`GET /agents/files`

## Request

- Base URL: `https://api.mobilerun.ai`
- URL: `https://api.mobilerun.ai/agents/files`
- Auth: HTTP bearer

## Query parameters

- `zone` 'user' | 'agent' | 'workflow' | 'skills'

## Response `200`

User's ready files

- object
  - `files` object[], required
    - `fileId` string, uuid, required
    - `filename` string, required
    - `displayName` string, nullable, required
    - `mimeType` string, required
    - `sizeBytes` number, required
    - `zone` 'user' | 'agent' | 'workflow' | 'skills', required
    - `enabled` boolean, required
    - `createdAt` string, date-time, required
    - `createdBy` 'user' | 'agent' | 'workflow', required
    - `collectionStatus` union
      - object
        - `version` 1, required
        - `completeness` 'complete' | 'partial' | 'none' | 'unknown', required
        - `coverage` 'exhaustive' | 'bounded' | 'unknown', required
        - `endReached` boolean, required
        - `resumable` boolean, required
        - `records` object, required
          - `reported` integer, required
          - `unit` string, required
      - object
        - `version` 1, required
        - `completeness` 'unknown', required
        - `coverage` 'unknown', required
        - `endReached` false, required
        - `resumable` false, required
  - `quota` object, required
    - `usedBytes` integer, required
    - `includedBytes` integer, nullable, required
    - `maxBytes` integer, nullable, required
    - `overageAllowed` boolean, required

## Other responses

- `401`: Unauthorized
- `500`: Internal Server Error
- `503`: Storage check temporarily unavailable

## Changes

- **2026-10-16** `4ad548c528a8`: 1 info
  - endpoint added
- **2026-06-18** `e61cfb7119bc`: 1 breaking
  - api path removed without deprecation
- **2026-06-09** `00b02e335076`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/agents/files/get.md)

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) - [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/droidrun/apis/droidrun-cloud/revisions/1cc95586c933?raw)