---
title: "Storage your workspace's uploads take [read]"
method: GET
path: "/files/usage"
tags: ["files"]
---

# Storage your workspace's uploads take \[read\]

`GET /files/usage`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/files/usage`
- Auth: HTTP bearer

Counts the universe's uploads and sums their bytes. There is no storage cap (`storage_limit_bytes` is null); each file is bounded by `max_file_bytes`.

## Response `200`

OK

- FilesUsage
  - `type` 'files_usage', required
  - `file_count` integer, required: The workspace's uploads, expired and deleted ones left out
  - `size_bytes` integer, required: The bytes those uploads take
  - `max_file_bytes` integer, required: The largest single file an upload accepts (50 GiB)
  - `storage_limit_bytes` unknown, required

## Other responses

- `default`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/files/usage/get.md)

---

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