One change
List Files
api/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.
api/files/list Changed · +21 / -14 lines
# List Files ## Query parameters ## Returns ## Example ### Response (200) ## List Files ### Query Parameters ### Returns ### Example #### Response
from line 1
---- -title: List Files -url: https://platform.claude.com/docs/en/api/files/list ---- +# List Files -## List Files +**GET** `/v1/files` -**get** `/v1/files` - List Files -### Query Parameters +## Query parameters - `ids: optional array of string`
from line 16
Defaults to `20`. Ranges from `1` to `1000`. + default: 20, maximum: 1000, minimum: 1 + - `page: optional string` Opaque page cursor returned in a prior list response's `next_page`. Prefixed `page_`. -### Returns +## Returns - `data: array of FileMetadata`
from line 38
RFC 3339 datetime string representing when the file was created. + format: date-time + - `filename: string` Original filename of the uploaded file. + maxLength: 500, minLength: 1 + - `mime_type: string` MIME type of the file. + maxLength: 255, minLength: 1 + - `size_bytes: number` Size of the file in bytes. + minimum: 0 + - `type: "file"` Object type.
from line 64
For files, this is always `"file"`. - - `"file"` - - `downloadable: optional boolean` Whether the file can be downloaded. + default: false + - `expires_at: optional string or null` 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. + format: date-time + - `next_page: optional string or null` Opaque cursor for the next page. Supply as `?page=` to fetch the next page; null when there are no more results. -### Example +## Example -```http +```bash curl https://api.anthropic.com/v1/files \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +### Response (200) ```json {