One change
Get File Metadata
api/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.
api/beta/files/retrieve_metadata Changed · +19 / -18 lines
# Get File Metadata ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Get File Metadata ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
from line 1
---- -title: Get File Metadata -url: https://platform.claude.com/docs/en/api/beta/files/retrieve_metadata ---- +# Get File Metadata -## Get File Metadata +**GET** `/v1/files/{file_id}` -**get** `/v1/files/{file_id}` - Get File Metadata -### Path Parameters +## Path parameters - `file_id: string` ID of the File. -### Header Parameters +## Headers - `"anthropic-beta": optional array of AnthropicBeta`
from line 88
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns +## Returns -- `BetaFileMetadata object { id, created_at, filename, 5 more }` +- `BetaFileMetadata object` - `id: string`
from line 102
RFC 3339 datetime string representing when the file was created. + format: date-time + - `filename: string` Original filename of the uploaded file. + maxLength: 500, minLength: 1 + - `mime_type: string` MIME type of the file. + maxLength: 255, minLength: 1 + - `size_bytes: number` Size of the file in bytes. + minimum: 0 + - `type: "file"` Object type.
from line 128
For files, this is always `"file"`. - - `"file"` - - `downloadable: optional boolean` Whether the file can be downloaded. + default: false + - `scope: optional BetaFileScope or null` The scope of this file, indicating the context in which it was created (e.g., a session).
from line 146
The type of scope (e.g., `"session"`). - - `"session"` +## Example -### Example - -```http +```bash curl https://api.anthropic.com/v1/files/$FILE_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: files-api-2025-04-14' \
from line 155
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +### Response (200) ```json {