Loading...
    • Developer Guide
    • API Reference
    • MCP
    • Resources
    • Release Notes
    Search...
    ⌘K
    Using the API
    API overviewBeta 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(FileUploadParamsparameters, CancellationTokencancellationToken = default)
    POST/v1/files
    List Files
    FileListPageResponse Beta.Files.List(FileListParams?parameters, CancellationTokencancellationToken = default)
    GET/v1/files
    Download File
    HttpResponse Beta.Files.Download(FileDownloadParamsparameters, CancellationTokencancellationToken = default)
    GET/v1/files/{file_id}/content
    Get File Metadata
    FileMetadata Beta.Files.RetrieveMetadata(FileRetrieveMetadataParamsparameters, CancellationTokencancellationToken = default)
    GET/v1/files/{file_id}
    Delete File
    DeletedFile Beta.Files.Delete(FileDeleteParamsparameters, CancellationTokencancellationToken = default)
    DELETE/v1/files/{file_id}
    ModelsExpand Collapse
    class DeletedFile:
    required string ID

    ID of the deleted file.

    Type Type

    Deleted object type.

    For file deletion, this is always "file_deleted".

    class FileMetadata:
    required string ID

    Unique object identifier.

    The format and length of IDs may change over time.

    required DateTimeOffset CreatedAt

    RFC 3339 datetime string representing when the file was created.

    required string Filename

    Original filename of the uploaded file.

    required string MimeType

    MIME type of the file.

    required Long SizeBytes

    Size of the file in bytes.

    JsonElement Type "file"constant

    Object type.

    For files, this is always "file".

    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