Get File Metadata
api/files/retrieve_metadata
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/retrieve_metadata Changed · +20 / -15 lines
# Get File Metadata ## Path parameters ## Returns ## Example ### Response (200) ## Get File Metadata ### Path Parameters ### Returns ### Example #### Response
---- -title: Get File Metadata -url: https://platform.claude.com/docs/en/api/files/retrieve_metadata ---- +# Get File Metadata -## Get File Metadata +**GET** `/v1/files/{file_id}` -**get** `/v1/files/{file_id}` - Get File Metadata -### Path Parameters +## Path parameters - `file_id: string` ID of the File. -### Returns +## Returns -- `FileMetadata object { id, created_at, filename, 5 more }` +- `FileMetadata object` - `id: string`
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.
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. -### Example + format: date-time -```http +## Example + +```bash curl https://api.anthropic.com/v1/files/$FILE_ID \ -H 'anthropic-version: 2023-06-01' \ -H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +### Response (200) ```json {