← Back to daily report

api/beta/files/upload.md

Changed on 2026-03-03 11:40:32 EST

Unified Diff

--- a/api/beta/files/upload.md
+++ b/api/beta/files/upload.md
@@ -0,0 +1,104 @@
+## Upload
+
+**post** `/v1/files`
+
+Upload File
+
+### Header Parameters
+
+- `"anthropic-beta": optional array of AnthropicBeta`
+
+  Optional header to specify the beta version(s) you want to use.
+
+  - `UnionMember0 = string`
+
+  - `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more`
+
+    - `"message-batches-2024-09-24"`
+
+    - `"prompt-caching-2024-07-31"`
+
+    - `"computer-use-2024-10-22"`
+
+    - `"computer-use-2025-01-24"`
+
+    - `"pdfs-2024-09-25"`
+
+    - `"token-counting-2024-11-01"`
+
+    - `"token-efficient-tools-2025-02-19"`
+
+    - `"output-128k-2025-02-19"`
+
+    - `"files-api-2025-04-14"`
+
+    - `"mcp-client-2025-04-04"`
+
+    - `"mcp-client-2025-11-20"`
+
+    - `"dev-full-thinking-2025-05-14"`
+
+    - `"interleaved-thinking-2025-05-14"`
+
+    - `"code-execution-2025-05-22"`
+
+    - `"extended-cache-ttl-2025-04-11"`
+
+    - `"context-1m-2025-08-07"`
+
+    - `"context-management-2025-06-27"`
+
+    - `"model-context-window-exceeded-2025-08-26"`
+
+    - `"skills-2025-10-02"`
+
+    - `"fast-mode-2026-02-01"`
+
+### Returns
+
+- `FileMetadata = object { id, created_at, filename, 4 more }`
+
+  - `id: string`
+
+    Unique object identifier.
+
+    The format and length of IDs may change over time.
+
+  - `created_at: string`
+
+    RFC 3339 datetime string representing when the file was created.
+
+  - `filename: string`
+
+    Original filename of the uploaded file.
+
+  - `mime_type: string`
+
+    MIME type of the file.
+
+  - `size_bytes: number`
+
+    Size of the file in bytes.
+
+  - `type: "file"`
+
+    Object type.
+
+    For files, this is always `"file"`.
+
+    - `"file"`
+
+  - `downloadable: optional boolean`
+
+    Whether the file can be downloaded.
+
+### Example
+
+```http
+curl https://api.anthropic.com/v1/files?beta=true \
+    -H 'Content-Type: multipart/form-data' \
+    -H 'anthropic-version: 2023-06-01' \
+    -H 'anthropic-beta: files-api-2025-04-14' \
+    -H "X-Api-Key: $ANTHROPIC_API_KEY" \
+    -F 'file=@/path/to/file'
+```