The whole hunk
from line 6, old and new numbered
/
lines
from line 6
66
77## Query parameters
88
9- `after_id: optional string`
9- `ids: optional array of string`
1010
11 ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
11 Restrict the result set to Files whose `id` is in this list. At most 100 entries (after de-duplication). Mutually exclusive with `page` and `limit`. When supplied, the response is always a single page (`next_page` is null). IDs that do not resolve to a visible File — including deleted Files — are silently omitted.
1212
13- `before_id: optional string`
14
15 ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
16
1713- `limit: optional number`
1814
1915 Number of items to return per page.
from line 18
2218
2319 default: 20, maximum: 1000, minimum: 1
2420
21- `page: optional string`
22
23 Opaque page cursor returned in a prior list response's `next_page`. Prefixed `page_`.
24
2525- `scope_id: optional string`
2626
2727 Filter by scope ID. Only returns files associated with the specified scope (e.g., a session ID).
from line 166
166166
167167 default: false
168168
169 - `expires_at: optional string or null`
170
171 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.
172
173 format: date-time
174
169175 - `scope: optional BetaFileScope or null`
170176
171177 The scope of this file, indicating the context in which it was created (e.g., a session).
from line 184
178184
179185 The type of scope (e.g., `"session"`).
180186
181- `first_id: optional string or null`
187- `next_page: optional string or null`
182188
183 ID of the first file in this page of results.
189 Opaque cursor for the next page. Supply as `?page=` to fetch the next page; null when there are no more results.
184190
185- `has_more: optional boolean`
186
187 Whether there are more results available.
188
189 default: false
190
191- `last_id: optional string or null`
192
193 ID of the last file in this page of results.
194
195191## Example
196192
197193```bash
198194curl https://api.anthropic.com/v1/files \
199195 -H 'anthropic-version: 2023-06-01' \
200 -H 'anthropic-beta: files-api-2025-04-14' \
201196 -H "X-Api-Key: $ANTHROPIC_API_KEY"
202197```
203198
from line 209
214209 "size_bytes": 102400,
215210 "type": "file",
216211 "downloadable": false,
212 "expires_at": "2025-05-15T18:37:24.100435Z",
217213 "scope": {
218214 "id": "id",
219215 "type": "session"
from line 216
220216 }
221217 }
222218 ],
223 "first_id": "file_011CNha8iCJcU1wXNR6q4V8w",
224 "has_more": true,
225 "last_id": "file_013Zva2CMHLNnXjNJJKqJ2EF"
219 "next_page": "next_page"
226220}
227221```
228222