Files

Delete File

beta.files.delete(file_id, **kwargs) -> DeletedFile { id, type }

delete/v1/files/{file_id}?beta=true

Download File

beta.files.download(file_id, **kwargs) -> StringIO

get/v1/files/{file_id}/content?beta=true

List Files

beta.files.list(**kwargs) -> Page<FileMetadata { id, created_at, filename, 4 more } >

get/v1/files?beta=true

Get File Metadata

beta.files.retrieve_metadata(file_id, **kwargs) -> FileMetadata { id, created_at, filename, 4 more }

get/v1/files/{file_id}?beta=true

Upload File

beta.files.upload(**kwargs) -> FileMetadata { id, created_at, filename, 4 more }

post/v1/files?beta=true

ModelsExpand Collapse

class DeletedFile { id, type }

id: String

ID of the deleted file.

type: :file_deleted

Deleted object type.

For file deletion, this is always "file_deleted".

Accepts one of the following:

:file_deleted

class FileMetadata { id, created_at, filename, 4 more }

id: String

Unique object identifier.

The format and length of IDs may change over time.

created_at: Time

RFC 3339 datetime string representing when the file was created.

formatdate-time

filename: String

Original filename of the uploaded file.

maxLength500

minLength1

mime_type: String

MIME type of the file.

maxLength255

minLength1

size_bytes: Integer

Size of the file in bytes.

minimum0

type: :file

Object type.

For files, this is always "file".

Accepts one of the following:

:file

downloadable: bool

Whether the file can be downloaded.

Files

Delete File

beta.files.delete(file_id, **kwargs) -> DeletedFile { id, type }

delete/v1/files/{file_id}?beta=true

Download File

beta.files.download(file_id, **kwargs) -> StringIO

get/v1/files/{file_id}/content?beta=true

List Files

beta.files.list(**kwargs) -> Page<FileMetadata { id, created_at, filename, 4 more } >

get/v1/files?beta=true

Get File Metadata

beta.files.retrieve_metadata(file_id, **kwargs) -> FileMetadata { id, created_at, filename, 4 more }

get/v1/files/{file_id}?beta=true

Upload File

beta.files.upload(**kwargs) -> FileMetadata { id, created_at, filename, 4 more }

post/v1/files?beta=true

ModelsExpand Collapse

class DeletedFile { id, type }

id: String

ID of the deleted file.

type: :file_deleted

Deleted object type.

For file deletion, this is always "file_deleted".

Accepts one of the following:

:file_deleted

class FileMetadata { id, created_at, filename, 4 more }

id: String

Unique object identifier.

The format and length of IDs may change over time.

created_at: Time

RFC 3339 datetime string representing when the file was created.

formatdate-time

filename: String

Original filename of the uploaded file.

maxLength500

minLength1

mime_type: String

MIME type of the file.

maxLength255

minLength1

size_bytes: Integer

Size of the file in bytes.

minimum0

type: :file

Object type.

For files, this is always "file".

Accepts one of the following:

:file

downloadable: bool

Whether the file can be downloaded.

Files

Delete File

Download File

List Files

Get File Metadata

Upload File

ModelsExpand Collapse

Products

Features

Models

Solutions

Claude Developer Platform

Learn

Company

Help and security

Terms and policies

Files

Delete File

Download File

List Files

Get File Metadata

Upload File

ModelsExpand Collapse

Products

Features

Models

Solutions

Claude Developer Platform

Learn

Company

Help and security

Terms and policies