---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.com/dev/disk/doc/en/reference/put.md
  - https://yandex.com/dev/disk/doc/ru/reference/put.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/disk/doc/en/llms.txt

# Uploading a file (PUT)

Use the [PUT](http://www.webdav.org/specs/rfc4918.html#METHOD_PUT) method to upload a file to Yandex Disk.

At the beginning and end of uploading the file, the service checks whether the file exceeds the space available to the user on Disk. If there is not enough space, the service returns a response with the code `507 Insufficient Storage`.

Support is provided for transferring compressed files (`Content-Encoding: gzip` header) and chunked files (`Transfer-Encoding: chunked`).

## Checking for duplicate files

Users often want to upload files to Yandex Disk that have already been uploaded by someone else. In such cases, Disk can just copy the needed file on the server, without uploading it.

The file is identified by the file size, MD5 checksum, and SHA-256 hash. The following headers are used for passing them:

```yaml
Etag: <md5 checksum>
Sha256: <SHA-256 hash>
Content-Length: <file size in bytes>
```

If a duplicate file is found, the server responds with the code `201 Created`.

# Example of uploading
>
> The app uploads the ##otpusk.avi## file to the ##/a/## directory on the user's Disk, specifying the checksum and hash for checking for duplicates.
>
> ```yaml
> PUT /a/otpusk.avi HTTP/1.1
> Host: webdav.yandex.ru
> Accept: */*
> Authorization: OAuth 0c4181a7c2cf4521964a72ff57a34a07
> Etag: 1bc29b36f623ba82aaf6724fd3b16718
> Sha256: T8A8H6B407D7809569CA9ABCB0082E4F8D5651E46D3CDB762D02D0BF37C9E592
> Expect: 100-continue
> Content-Type: application/binary
> Content-Length: 103134024
> ```
>
> If Yandex Disk found a duplicate file and doesn't need to upload anything, the server responds with the code `201 Created`.
>
> If a duplicate was not found, the server responds with the code `100 Continue`, allowing the file to be uploaded in the body of the next request. When the file has been uploaded successfully, the server also responds with the code `201 Created`.