← Back to daily report

api/files-create.md

Changed on 2026-02-17 13:51:08 EST

+9 lines added
-0 lines removed
Visual Diff
## 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'¶
```¶

Unified Diff

--- a/api/files-create.md
+++ b/api/files-create.md
@@ -91,3 +91,14 @@
   - `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'
+```