Claude Platform Docs

Files

Upload File
beta.files.upload(**kwargs) -> BetaFileMetadata
POST/v1/files
List Files
beta.files.list(**kwargs) -> PageCursor<BetaFileMetadata>
GET/v1/files
Download File
beta.files.download(file_id, **kwargs) -> StringIO
GET/v1/files/{file_id}/content
Get File Metadata
beta.files.retrieve_metadata(file_id, **kwargs) -> BetaFileMetadata
GET/v1/files/{file_id}
Delete File
beta.files.delete(file_id, **kwargs) -> BetaDeletedFile
DELETE/v1/files/{file_id}
Models
class BetaDeletedFile { id, type }
id: String

ID of the deleted file.

type: :file_deleted

Deleted object type.

For file deletion, this is always "file_deleted".

class BetaFileMetadata { id, created_at, filename, 6 more }
class BetaFileScope { id, type }
id: String

The ID of the scoping resource (e.g., the session ID).

type: :session

The type of scope (e.g., "session").