files changedbuild-with-claude/files
Nearest release: v2.1.235, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+9added
Lines−6removed
From line
32
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits24to this page, all time
### Audit logging
The whole hunk
from line 32, old and new numbered
/
from line 32
3232
3333<Warning id="workspace-scoped-access">
3434 **Uploaded files are accessible to your entire workspace, not scoped to an end user, conversation, or session.** Any API key in the same workspace can access any file uploaded there, and all of your keys share your organization's Default Workspace unless you have assigned them to separate [workspaces](https://platform.claude.com/docs/en/manage-claude/workspaces#api-keys-and-resource-scoping). Never accept `file_id` values from end users or other untrusted sources: a user-supplied file ID would let one user of your application read content that another user uploaded. Treat file IDs as server-side references, and keep the mapping between your users and their files in your application.
35
36 If you are building a multi-tenant application on the Files API, create a separate [workspace](https://platform.claude.com/docs/en/manage-claude/workspaces) for each tenant. The workspace is the isolation boundary for files, so a workspace per tenant gives each tenant's data hard isolation from every other tenant. Each organization can have up to 100 workspaces; contact your account team if you need more.
3537</Warning>
3638
3739## How to use the Files API
from line 980
978980### Storage limits
979981
980982* **Maximum file size:** 500 MB per file
981* **Total storage:** 500 GB per organization
983* **Total storage:** 1 TB per organization
982984
983985### File lifecycle
984986
from line 991
989991* Files are inaccessible through the API shortly after deletion, but they may persist in active Messages API calls and associated tool uses
990992* Files that users delete will be deleted in accordance with Anthropic's [data retention policy](https://privacy.claude.com/en/articles/7996866-how-long-do-you-store-my-organization-s-data). For ZDR eligibility across all features, see [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention)
991993
994### Audit logging
995
996If your organization has the [Compliance API](https://platform.claude.com/docs/en/manage-claude/compliance-api) enabled, its [Activity Feed](https://platform.claude.com/docs/en/manage-claude/compliance-activity-feed) records Files API operations made with a Claude API key or from the Claude Console: each upload (`POST /v1/files`), content download (`GET /v1/files/{file_id}/content`), and deletion (`DELETE /v1/files/{file_id}`) appears as a `platform_file_uploaded`, `platform_file_content_downloaded`, or `platform_file_deleted` activity. Listing files and retrieving file metadata are not recorded. Operations that occur while the Compliance API is off are not recorded and cannot be recovered later, so [set up the Compliance API](https://platform.claude.com/docs/en/manage-claude/compliance-api-access) before you rely on this audit trail. On [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#monitoring-and-logging), audit file operations with AWS CloudTrail data events instead.
997
992998## Error handling
993999
9941000Common errors when using the Files API include:
from line 1005
9991005* **Exceeds context window size (400):** The file is larger than the context window size (for example, using a 500 MB plain text file in a `/v1/messages` request)
10001006* **Invalid filename (400):** The file name doesn't meet the length requirements (1-255 characters) or contains forbidden characters (`<`, `>`, `:`, `"`, `|`, `?`, `*`, `\`, `/`, or Unicode characters 0-31)
10011007* **File too large (413):** File exceeds the 500 MB limit
1002* **Storage limit exceeded (400):** Your organization has reached the 500 GB storage limit
1008* **Storage limit exceeded (400):** Your organization has reached the 1 TB storage limit
10031009
10041010```json Output
10051011{
from line 1032
10261032
10271033### Rate limits
10281034
1029During the beta period:
1030
1031* File-related API calls are limited to approximately 100 requests per minute
1032* [Contact us](mailto:[email protected]) if you need higher limits for your use case
1035File-related API calls are limited to approximately 500 requests per minute. To request a higher limit, [contact sales](mailto:[email protected]).
10331036
10341037## Next steps
10351038
No line in this hunk matches that.