ファイル - Claude API Reference

ファイルメタデータの取得

GET/v1/compliance/apps/chats/files/{claude_file_id}

チャットメッセージで参照されているファイルのメタデータを、ファイルコンテンツをダウンロードせずに取得します。バイトデータをダウンロードするには、兄弟エンドポイントである /content を使用してください。

ファイルの削除

DELETE/v1/compliance/apps/chats/files/{claude_file_id}

特定のファイルを完全に削除します。これは元に戻すことができない破壊的な操作です。

ファイルコンテンツのダウンロード

GET/v1/compliance/apps/chats/files/{claude_file_id}/content

チャットメッセージで参照されているファイルのバイナリコンテンツをダウンロードします。

Models

FileRetrieveResponse object{ id, claude_chat_ids, created_at, 5 more }

File metadata for GET /v1/compliance/apps/chats/files/{claude_file_id}.

Returns metadata only. Use the sibling /content endpoint to download the file bytes.

id: string

File ID

claude_chat_ids: array of string

Chats this file is attached to. A file can be referenced by messages across multiple chats.

created_at: string

File creation timestamp

formatdate-time

filename: string or null

Display name of the file, if set

md5: string or null

Lowercase hex MD5 of the file's preferred downloadable variant, as recorded at upload time. Null when no stored hash is available. The sibling /content endpoint also sets a Content-MD5 header (base64 per RFC 1864) computed over the exact served bytes; when the two disagree, the header is authoritative.

message_ids: array of string

Chat message IDs this file is attached to. A file can be referenced by multiple messages.

mime_type: string or null

MIME type of the file's preferred downloadable variant (e.g. 'application/pdf'). May be null for files with no downloadable content (e.g. code-interpreter outputs).

size_bytes: number or null

Size in bytes of the file's preferred downloadable variant, if known

FileDeleteResponse object{ type: "claude_file_deleted", id }

Response for deleting a compliance file.

type: optional "claude_file_deleted"

Constant string confirming deletion

defaultclaude_file_deleted

id: string

The ID of the file that was deleted