---
title: "Get Workspace Size"
method: GET
path: "/workspaces/{workspace_id}/size"
tags: ["Workspaces"]
---

# Get Workspace Size

`GET /workspaces/{workspace_id}/size`

## Request

- Base URL: `https://api.browser-use.com/api/v4`
- URL: `https://api.browser-use.com/api/v4/workspaces/{workspace_id}/size`
- Auth: API key in header `X-Browser-Use-API-Key`

Return current storage usage and the plan-specific workspace quota.

## Path parameters

- `workspace_id` string, uuid, required

## Response `200`

Successful Response

- WorkspaceSizeInfo
  - `usedBytes` integer, required: Current workspace storage usage in bytes.
  - `maxBytes` integer, required: Maximum workspace storage allowed in bytes.

## Other responses

- `404`: Run, session, workspace, or profile not found.
- `422`: Validation Error

---

[API](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4.md) · [All operations](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/llms.txt) · [OpenAPI document](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/revisions/cd7b1eee1102?raw)