Get File Metadata changedapi/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.
Recorded here
Lines+20added
Lines−15removed
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
# Get File Metadata ## Path parameters ## Returns ## Example ### Response (200) ## Get File Metadata ### Path Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Get File Metadata
3url: https://platform.claude.com/docs/en/api/files/retrieve_metadata
4---
1# Get File Metadata
52
6## Get File Metadata
3**GET** `/v1/files/{file_id}`
74
8**get** `/v1/files/{file_id}`
9
105Get File Metadata
116
12### Path Parameters
7## Path parameters
138
149- `file_id: string`
1510
1611 ID of the File.
1712
18### Returns
13## Returns
1914
20- `FileMetadata object { id, created_at, filename, 5 more }`
15- `FileMetadata object`
2116
2217 - `id: string`
2318
from line 24
2924
3025 RFC 3339 datetime string representing when the file was created.
3126
27 format: date-time
28
3229 - `filename: string`
3330
3431 Original filename of the uploaded file.
3532
33 maxLength: 500, minLength: 1
34
3635 - `mime_type: string`
3736
3837 MIME type of the file.
3938
39 maxLength: 255, minLength: 1
40
4041 - `size_bytes: number`
4142
4243 Size of the file in bytes.
4344
45 minimum: 0
46
4447 - `type: "file"`
4548
4649 Object type.
from line 50
4750
4851 For files, this is always `"file"`.
4952
50 - `"file"`
51
5253 - `downloadable: optional boolean`
5354
5455 Whether the file can be downloaded.
5556
57 default: false
58
5659 - `expires_at: optional string or null`
5760
5861 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.
5962
60### Example
63 format: date-time
6164
62```http
65## Example
66
67```bash
6368curl https://api.anthropic.com/v1/files/$FILE_ID \
6469 -H 'anthropic-version: 2023-06-01' \
6570 -H "X-Api-Key: $ANTHROPIC_API_KEY"
6671```
6772
68#### Response
73### Response (200)
6974
7075```json
7176{
No line in this hunk matches that.