---
title: "Usage"
description: "Read how much storage a workspace uses and what its plan allows."
---

> Documentation Index
> Fetch the complete documentation index at: https://tarkle.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage

| Method and path | Scope | What it does |
| --- | --- | --- |
| `GET /usage` | `files:read` | Storage used, the limit and what is free |

```bash
curl -H "Authorization: Bearer $TARKLE_TOKEN" -H "X-Workspace-Key: $KEY" https://tarkle.com/api/v1/usage
```

```json
{ "storage": { "used_bytes": 123456789, "limit_bytes": 3298534883328, "free_bytes": 3298411426539 } }
```

A `limit_bytes` of `null` means the plan sets none. Check this before a large upload to avoid `413 storage_full`.

Source: https://tarkle.com/docs/api/usage/index.mdx