List Files changedapi/beta/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+24added
Lines−19removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits19to this page, all time
# List Files ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Files ### Query Parameters ### Header 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/beta/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- `after_id: optional string`
1510
from line 20
2520
2621 Defaults to `20`. Ranges from `1` to `1000`.
2722
23 default: 20, maximum: 1000, minimum: 1
24
2825- `scope_id: optional string`
2926
3027 Filter by scope ID. Only returns files associated with the specified scope (e.g., a session ID).
3128
32### Header Parameters
29## Headers
3330
3431- `"anthropic-beta": optional array of AnthropicBeta`
3532
from line 104
107104
108105 - `"mid-conversation-tool-changes-2026-07-01"`
109106
110### Returns
107## Returns
111108
112109- `data: array of BetaFileMetadata`
113110
from line 120
123120
124121 RFC 3339 datetime string representing when the file was created.
125122
123 format: date-time
124
126125 - `filename: string`
127126
128127 Original filename of the uploaded file.
129128
129 maxLength: 500, minLength: 1
130
130131 - `mime_type: string`
131132
132133 MIME type of the file.
133134
135 maxLength: 255, minLength: 1
136
134137 - `size_bytes: number`
135138
136139 Size of the file in bytes.
137140
141 minimum: 0
142
138143 - `type: "file"`
139144
140145 Object type.
from line 146
141146
142147 For files, this is always `"file"`.
143148
144 - `"file"`
145
146149 - `downloadable: optional boolean`
147150
148151 Whether the file can be downloaded.
149152
153 default: false
154
150155 - `scope: optional BetaFileScope or null`
151156
152157 The scope of this file, indicating the context in which it was created (e.g., a session).
from line 164
159164
160165 The type of scope (e.g., `"session"`).
161166
162 - `"session"`
163
164167- `first_id: optional string or null`
165168
166169 ID of the first file in this page of results.
from line 172
169172
170173 Whether there are more results available.
171174
175 default: false
176
172177- `last_id: optional string or null`
173178
174179 ID of the last file in this page of results.
175180
176### Example
181## Example
177182
178```http
183```bash
179184curl https://api.anthropic.com/v1/files \
180185 -H 'anthropic-version: 2023-06-01' \
181186 -H 'anthropic-beta: files-api-2025-04-14' \
from line 187
182187 -H "X-Api-Key: $ANTHROPIC_API_KEY"
183188```
184189
185#### Response
190### Response (200)
186191
187192```json
188193{
No line in this hunk matches that.