Dateien

Datei hochladen

client.Beta.Files.Upload(ctx, params) (*BetaFileMetadata, error)

POST/v1/files

Dateien auflisten

client.Beta.Files.List(ctx, params) (*PageCursor[BetaFileMetadata], error)

GET/v1/files

Datei herunterladen

client.Beta.Files.Download(ctx, fileID, query) (*Response, error)

GET/v1/files/{file_id}/content

Dateimetadaten abrufen

client.Beta.Files.GetMetadata(ctx, fileID, query) (*BetaFileMetadata, error)

GET/v1/files/{file_id}

Datei löschen

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).