From d593a11655a39315073dcce80689bae06ee12f1f Mon Sep 17 00:00:00 2001
From: Vadim Manikhin <vadim.manikhin@gmail.com>
Date: Tue, 28 Feb 2017 15:58:15 +0400
Subject: [PATCH] upload file docs

---
 source/includes/_item.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/source/includes/_item.md b/source/includes/_item.md
index 31a8e6216be..61f3c6072c8 100644
--- a/source/includes/_item.md
+++ b/source/includes/_item.md
@@ -165,6 +165,21 @@ It returns X-Cursor HTTP header. Cursor is a unix timestamp (in milliseconds) of
 
 * `POST    /item` will create new item
 
+### 2.1 Upload file
+
+* `POST /file/upload` will upload file and create respective file item
+* Request Content-Type should be `multipart/form-data`
+
+### Mandatory params:
+Param | Type | Description
+------------ | ------------- | ------------
+<code>session_id</code>| text | User session.
+<code>file</code>| binary | Content of file to upload.
+
+### Response fields:
+Field | Type | Description
+------------ | ------------- | ------------
+<code>id</code>| long | Globally unique primary identifier for a file item.
 
 ## 3. Update Item