Loading...
    • Developer Guide
    • API Reference
    • MCP
    • Resources
    • Release Notes
    Search...
    ⌘K
    Using the API
    Features overviewClient SDKsBeta headersErrors
    Messages
    Create a Message
    Count tokens in a Message
    Models
    List Models
    Get a Model
    Beta
    Upload File
    List Files
    Download File
    Get File Metadata
    Delete File
    Admin
    Completions
    Create a Text Completion
    Support & configuration
    Rate limitsService tiersVersionsIP addressesSupported regionsOpenAI SDK compatibility
    Console
    Log in

    Files

    Upload File
    FileMetadata beta().files().upload(FileUploadParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
    post/v1/files
    List Files
    FileListPage beta().files().list(FileListParamsparams = FileListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
    get/v1/files
    Download File
    HttpResponse beta().files().download(FileDownloadParamsparams = FileDownloadParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
    get/v1/files/{file_id}/content
    Get File Metadata
    FileMetadata beta().files().retrieveMetadata(FileRetrieveMetadataParamsparams = FileRetrieveMetadataParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
    get/v1/files/{file_id}
    Delete File
    DeletedFile beta().files().delete(FileDeleteParamsparams = FileDeleteParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
    delete/v1/files/{file_id}
    ModelsExpand Collapse
    class DeletedFile:
    String id

    ID of the deleted file.

    Optional<Type> type

    Deleted object type.

    For file deletion, this is always "file_deleted".

    Accepts one of the following:
    FILE_DELETED("file_deleted")
    class FileMetadata:
    String id

    Unique object identifier.

    The format and length of IDs may change over time.

    LocalDateTime createdAt

    RFC 3339 datetime string representing when the file was created.

    formatdate-time
    String filename

    Original filename of the uploaded file.

    maxLength500
    minLength1
    String mimeType

    MIME type of the file.

    maxLength255
    minLength1
    long sizeBytes

    Size of the file in bytes.

    minimum0
    JsonValue; type "file"constant"file"constant

    Object type.

    For files, this is always "file".

    Accepts one of the following:
    FILE("file")
    Optional<Boolean> downloadable

    Whether the file can be downloaded.

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy