Upload File changedapi/beta/files/upload
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+26added
Lines−17removed
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
# Upload File ## Headers ## Body parameters (form-data) ## Returns ## Example ### Response (200) ## Upload File ### Header Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Upload File
3url: https://platform.claude.com/docs/en/api/beta/files/upload
4---
1# Upload File
52
6## Upload File
3**POST** `/v1/files`
74
8**post** `/v1/files`
9
105Upload File
116
12### Header Parameters
7## Headers
138
149- `"anthropic-beta": optional array of AnthropicBeta`
1510
from line 82
8782
8883 - `"mid-conversation-tool-changes-2026-07-01"`
8984
90### Returns
85## Body parameters (form-data)
9186
92- `BetaFileMetadata object { id, created_at, filename, 5 more }`
87- `file: string`
9388
89 The file to upload
90
91 format: binary
92
93## Returns
94
95- `BetaFileMetadata object`
96
9497 - `id: string`
9598
9699 Unique object identifier.
from line 104
101104
102105 RFC 3339 datetime string representing when the file was created.
103106
107 format: date-time
108
104109 - `filename: string`
105110
106111 Original filename of the uploaded file.
107112
113 maxLength: 500, minLength: 1
114
108115 - `mime_type: string`
109116
110117 MIME type of the file.
111118
119 maxLength: 255, minLength: 1
120
112121 - `size_bytes: number`
113122
114123 Size of the file in bytes.
115124
125 minimum: 0
126
116127 - `type: "file"`
117128
118129 Object type.
from line 130
119130
120131 For files, this is always `"file"`.
121132
122 - `"file"`
123
124133 - `downloadable: optional boolean`
125134
126135 Whether the file can be downloaded.
127136
137 default: false
138
128139 - `scope: optional BetaFileScope or null`
129140
130141 The scope of this file, indicating the context in which it was created (e.g., a session).
from line 148
137148
138149 The type of scope (e.g., `"session"`).
139150
140 - `"session"`
151## Example
141152
142### Example
143
144```http
153```bash
145154curl https://api.anthropic.com/v1/files \
146155 -H 'Content-Type: multipart/form-data' \
147156 -H 'anthropic-version: 2023-06-01' \
from line 159
150159 -F 'file=@/path/to/file'
151160```
152161
153#### Response
162### Response (200)
154163
155164```json
156165{
No line in this hunk matches that.