Claude Platform Docs

Files

Upload File
$ ant files upload
POST/v1/files
List Files
$ ant files list
GET/v1/files
Download File
$ ant files download
GET/v1/files/{file_id}/content
Get File Metadata
$ ant files retrieve-metadata
GET/v1/files/{file_id}
Delete File
$ ant files delete
DELETE/v1/files/{file_id}
Models
deleted_file: object{ type: "file_deleted", id }
type: optional "file_deleted"

Deleted object type.

For file deletion, this is always "file_deleted".

id: string

ID of the deleted file.

file_expired_error_details: object{ error_code }
error_code: "file_expired"
file_metadata: object{ type: "file", id, created_at, 5 more }
type: "file"

Object type.

For files, this is always "file".

id: string

Unique object identifier.

The format and length of IDs may change over time.

created_at: string

RFC 3339 datetime string representing when the file was created.

formatdate-time
filename: string

Original filename of the uploaded file.

minLength1
maxLength500
mime_type: string

MIME type of the file.

minLength1
maxLength255
size_bytes: number

Size of the file in bytes.

minimum0
downloadable: optional boolean

Whether the file can be downloaded.

expires_at: optional string

RFC 3339 datetime string representing when the file will expire and become unavailable for download. Null if the file does not expire. For files uploaded with expires_in_seconds, this is the upload time plus that value.

formatdate-time
file_not_downloadable_error_details: object{ error_code }
error_code: "file_not_downloadable"
storage_quota_exceeded_error_details: object{ error_code }
error_code: "storage_quota_exceeded"
Errors
"file_not_downloadable"⁠HTTP status 400

The file has downloadable: false. Only files generated by a tool, such as the code execution tool, can be downloaded.

details: object{ error_code }
error_code: "file_not_downloadable"
"storage_quota_exceeded"⁠HTTP status 400

The organization's file storage quota is exhausted. Delete files to free up space, then retry the upload.

details: object{ error_code }
error_code: "storage_quota_exceeded"
"file_expired"⁠HTTP status 404

The file's expires_at has passed, so its content is no longer available.

details: object{ error_code }
error_code: "file_expired"