Claude Platform Docs

Files

Upload File
client.Beta.Files.Upload(ctx, params) (*BetaFileMetadata, error)
POST/v1/files
List Files
client.Beta.Files.List(ctx, params) (*PageCursor[BetaFileMetadata], error)
GET/v1/files
Download File
client.Beta.Files.Download(ctx, fileID, query) (*Response, error)
GET/v1/files/{file_id}/content
Get File Metadata
client.Beta.Files.GetMetadata(ctx, fileID, query) (*BetaFileMetadata, error)
GET/v1/files/{file_id}
Delete File
client.Beta.Files.Delete(ctx, fileID, body) (*BetaDeletedFile, error)
DELETE/v1/files/{file_id}
Models
type BetaDeletedFile struct { Type: "file_deleted"; ID }
Type BetaDeletedFileType Optional

Deleted object type.

For file deletion, this is always "file_deleted".

defaultfile_deleted
ID string

ID of the deleted file.

type BetaFileMetadata struct { Type: "file"; ID; CreatedAt; /* 6 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.

CreatedAt Time

RFC 3339 datetime string representing when the file was created.

formatdate-time
Filename string

Original filename of the uploaded file.

minLength1
maxLength500
MimeType string

MIME type of the file.

minLength1
maxLength255
SizeBytes int64

Size of the file in bytes.

minimum0
Downloadable bool Optional

Whether the file can be downloaded.

defaultfalse
ExpiresAt Time Optional

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
Scope BetaFileScope Optional

The scope of this file, indicating the context in which it was created (e.g., a session).

Type Session

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

ID string

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

type BetaFileScope struct { Type: "session"; ID }
Type Session

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

ID string

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