> For AI agents: the documentation index is at https://docs.gethandup.dev/llms.txt. Append .md to any page URL (without the trailing slash) for Markdown, for example https://docs.gethandup.dev/cli.md.

# estimate

`GET /v1/storage/estimate`

What a cleanup would remove now, for the inline confirmation. Local, and view scope on paired devices.

## Parameters

### Query Parameters

- **target** (required): `string`

  history (requests, audit, unshared files) or files (files only)

  What a cleanup removes.

  Allowed values: `history` `files`

- **older_than_days**: `integer` format: int32, >= 0

  Only requests resolved at least this many days ago; 0 or absent = every resolved request

- **keep_newest**: `integer` format: int32, >= 0

  Keep the newest this many resolved requests; 0 or absent = no count limit

## Responses

### 200

Media type: `application/json`

`object`

What a cleanup would remove right now (an estimate: requests keep resolving).

- **requests** (required): `integer` format: int64, >= 0

  Resolved requests deleted (0 for a files-only cleanup).

- **files** (required): `integer` format: int64, >= 0

  Files removed from disk.

- **bytes** (required): `integer` format: int64, >= 0

  Approximate bytes freed: file sizes plus, for history, request and audit rows.

### 400

Invalid target