Get File Metadata changedapi/beta/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+19added
Lines−18removed
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
# Get File Metadata ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Get File Metadata ### Path Parameters ### Header 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/beta/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### Header Parameters
13## Headers
1914
2015- `"anthropic-beta": optional array of AnthropicBeta`
2116
from line 88
9388
9489 - `"mid-conversation-tool-changes-2026-07-01"`
9590
96### Returns
91## Returns
9792
98- `BetaFileMetadata object { id, created_at, filename, 5 more }`
93- `BetaFileMetadata object`
9994
10095 - `id: string`
10196
from line 102
107102
108103 RFC 3339 datetime string representing when the file was created.
109104
105 format: date-time
106
110107 - `filename: string`
111108
112109 Original filename of the uploaded file.
113110
111 maxLength: 500, minLength: 1
112
114113 - `mime_type: string`
115114
116115 MIME type of the file.
117116
117 maxLength: 255, minLength: 1
118
118119 - `size_bytes: number`
119120
120121 Size of the file in bytes.
121122
123 minimum: 0
124
122125 - `type: "file"`
123126
124127 Object type.
from line 128
125128
126129 For files, this is always `"file"`.
127130
128 - `"file"`
129
130131 - `downloadable: optional boolean`
131132
132133 Whether the file can be downloaded.
133134
135 default: false
136
134137 - `scope: optional BetaFileScope or null`
135138
136139 The scope of this file, indicating the context in which it was created (e.g., a session).
from line 146
143146
144147 The type of scope (e.g., `"session"`).
145148
146 - `"session"`
149## Example
147150
148### Example
149
150```http
151```bash
151152curl https://api.anthropic.com/v1/files/$FILE_ID \
152153 -H 'anthropic-version: 2023-06-01' \
153154 -H 'anthropic-beta: files-api-2025-04-14' \
from line 155
154155 -H "X-Api-Key: $ANTHROPIC_API_KEY"
155156```
156157
157#### Response
158### Response (200)
158159
159160```json
160161{
No line in this hunk matches that.