Interface OptimizeStorage

Optimizes storage usage, i.e. deletes some files and returns new storage usage statistics. Secret thumbnails can't be deleted. Request type for Tdjson#optimizeStorage.

interface OptimizeStorage {
    @type: "optimizeStorage";
    chat_ids: number[];
    chat_limit: number;
    count: number;
    exclude_chat_ids: number[];
    file_types: FileType[];
    immunity_delay: number;
    return_deleted_file_statistics?: boolean;
    size: number;
    ttl: number;
}

Properties

@type: "optimizeStorage"
chat_ids: number[]

If non-empty, only files from the given chats are considered. Use 0 as chat identifier to delete files not belonging to any chat (e.g., profile photos).

chat_limit: number

Same as in getStorageStatistics. Affects only returned statistics.

count: number

Limit on the total number of files after deletion. Pass -1 to use the default limit.

exclude_chat_ids: number[]

If non-empty, files from the given chats are excluded. Use 0 as chat identifier to exclude all files not belonging to any chat (e.g., profile photos).

file_types: FileType[]

If non-empty, only files with the given types are considered. By default, all types except thumbnails, profile photos, stickers and wallpapers are deleted.

immunity_delay: number

The amount of time after the creation of a file during which it can't be deleted, in seconds. Pass -1 to use the default value.

return_deleted_file_statistics?: boolean

Pass true if statistics about the files that were deleted must be returned instead of the whole storage usage statistics. Affects only returned statistics.

size: number

Limit on the total size of files after deletion, in bytes. Pass -1 to use the default limit.

ttl: number

Limit on the time that has passed since the last time a file was accessed (or creation time for some filesystems). Pass -1 to use the default limit.