List Files
List files within a workspace
The Files API allows you to upload and manage files to use with the Anthropic API without having to re-upload content with each request. For more information about the Files API, see the the developer guide for files.
The Files API is currently in beta. To use the Files API, you’ll need to include the beta feature header: anthropic-beta: files-api-2025-04-14
.
Please reach out through our feedback form to share your experience with the Files API.
Headers
Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like beta1,beta2
or specify the header multiple times for each beta.
Query Parameters
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
Number of items to return per page.
Defaults to 20
. Ranges from 1
to 1000
.
1 <= x <= 1000
Response
Successful Response
The response is of type object
.