List Files changedapi/files/list
Nearest release: v2.1.245, 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+21added
Lines−14removed
From line
1
where the diff opens
First seen
20 Aug 2026
this site's first read of the page
Recorded edits7to this page, all time
# List Files ## Query parameters ## Returns ## Example ### Response (200) ## List Files ### Query Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: List Files
3url: https://platform.claude.com/docs/en/api/files/list
4---
1# List Files
52
6## List Files
3**GET** `/v1/files`
74
8**get** `/v1/files`
9
105List Files
116
12### Query Parameters
7## Query parameters
138
149- `ids: optional array of string`
1510
from line 16
2116
2217 Defaults to `20`. Ranges from `1` to `1000`.
2318
19 default: 20, maximum: 1000, minimum: 1
20
2421- `page: optional string`
2522
2623 Opaque page cursor returned in a prior list response's `next_page`. Prefixed `page_`.
2724
28### Returns
25## Returns
2926
3027- `data: array of FileMetadata`
3128
from line 38
4138
4239 RFC 3339 datetime string representing when the file was created.
4340
41 format: date-time
42
4443 - `filename: string`
4544
4645 Original filename of the uploaded file.
4746
47 maxLength: 500, minLength: 1
48
4849 - `mime_type: string`
4950
5051 MIME type of the file.
5152
53 maxLength: 255, minLength: 1
54
5255 - `size_bytes: number`
5356
5457 Size of the file in bytes.
5558
59 minimum: 0
60
5661 - `type: "file"`
5762
5863 Object type.
from line 64
5964
6065 For files, this is always `"file"`.
6166
62 - `"file"`
63
6467 - `downloadable: optional boolean`
6568
6669 Whether the file can be downloaded.
6770
71 default: false
72
6873 - `expires_at: optional string or null`
6974
7075 RFC 3339 datetime string representing when the file will expire and become unavailable for download. Null if the file does not expire. For files uploaded with `expires_in_seconds`, this is the upload time plus that value.
7176
77 format: date-time
78
7279- `next_page: optional string or null`
7380
7481 Opaque cursor for the next page. Supply as `?page=` to fetch the next page; null when there are no more results.
7582
76### Example
83## Example
7784
78```http
85```bash
7986curl https://api.anthropic.com/v1/files \
8087 -H 'anthropic-version: 2023-06-01' \
8188 -H "X-Api-Key: $ANTHROPIC_API_KEY"
8289```
8390
84#### Response
91### Response (200)
8592
8693```json
8794{
No line in this hunk matches that.