Latest uploaded files

The number of recently uploaded files that should be described in the response (for example, for paginated output).

The default value is 20.

The type of files to include in the list. Yandex.Disk detects the type of each downloaded file.

To request multiple file types, list them in the parameter value and separate with commas. For example, media_type="audio,video".

Supported types:

• audio — Audio files.
• backup — Backup and temporary files.
• book — E-books.
• compressed — Compressed and archived files.
• data — Database files.
• development — Code files (C++, Java, XML and others), as well as IDE system files.
• diskimage — Images of media devices and associated files (such as ISO and CUE).
• document — Office documents (Word, OpenOffice, and so on).
• encoded — Encoded files.
• executable — Executable files.
• flash — Files with flash video or animation.
• font — Font files.
• image — Images.
• settings — Settings files for various programs.
• spreadsheet — Office spreadsheet files (Excel, Numbers, Lotus).
• text — Text files.
• unknown — Unknown file type.
• video — Video files.
• web — Various files used by browsers and websites (CSS, certificates, or bookmark files).

List of JSON keys to include in the response. Keys that are not included in this list will be discarded when forming the response. If the parameter is omitted, the response is returned in full, without discarding anything.

Key names should be comma-separated, and embedded keys should be separated by dots. For example: name, _embedded. items. path.

The desired size of the thumbnail (preview) file. The thumbnail link is returned in the preview key.

You can define the exact size of the preview, or the length of one of the sides. The resulting image can be cropped to a square using the preview_crop parameter.

Possible values

• Predefined length of the longest side.

  The image is reduced to the specified length of the longest side, and the proportions of the source image are preserved. For example, for the "S" size and a 120×200 image, a 90×150 preview is generated. For a 300×100 image, the preview is 150×50.

  Supported values:

  • "S" — 150 pixels.

  • "M" — 300 pixels.
  • "L" — 500 pixels.
  • "XL" — 800 pixels.
  • "XXL" — 1024 pixels.
  • "XXXL" — 1280 pixels.
• The exact width (for example, "120" or "120x") or the exact height (for example, "x145").

  The image is reduced to the specified width or height, and the proportions of the source image are preserved.

  If the preview_crop parameter is passed, a square with the set side length is cut out of the center of the reduced image.

• The exact size (in the <width>x<height> format, for example "120x240").

  The image is reduced to the smallest of the specified dimensions, and the proportions of the source image are preserved.

  If the preview_crop parameter is passed, a section is cut from the center of the source image with the maximum size in the set proportions of width to height (in the example, this is 1 to 2). Then the cropped section is scaled to the specified dimensions.

This parameter crops the preview to the size specified in the preview_size parameter.

Acceptable values:

• false — The parameter is ignored (default value).

• true — Crop the preview as follows:

  • If only the width or height is passed, the image is reduced to this size with the proportions preserved. Then a square with the specified length of side is cut out of the center of the reduced image.

  • If the exact size is passed (for example, "120x240"), a section is cut from the center of the source image with the maximum size in the set proportions of width to height. Then the cropped section is scaled to the specified dimensions.