1 files changed, 99 insertions, 7 deletions
diff --git a/docs/api-json-rpc.markdown b/docs/api-json-rpc.markdown
index 929d63fd..3e5d76a6 100644
--- a/docs/api-json-rpc.markdown
+++ b/docs/api-json-rpc.markdown
@@ -1916,7 +1916,7 @@ Response example:
 
 ### getTask
 
-- Purpose: **Get task information**
+- Purpose: **Get task by the unique id**
 - Parameters:
     - **task_id** (integer, required)
 - Result on success: **task properties**
@@ -1975,6 +1975,69 @@ Response example:
 }
 ```
 
+### getTaskByReference
+
+- Purpose: **Get task by the external reference**
+- Parameters:
+    - **project_id** (integer, required)
+    - **reference** (string, required)
+- Result on success: **task properties**
+- Result on failure: **null**
+
+Request example:
+
+```json
+{
+    "jsonrpc": "2.0",
+    "method": "getTaskByReference",
+    "id": 1992081213,
+    "params": {
+        "project_id": 1,
+        "reference": "TICKET-1234"
+    }
+}
+```
+
+Response example:
+
+```json
+{
+    "jsonrpc": "2.0",
+    "id": 1992081213,
+    "result": {
+        "id": "5",
+        "title": "Task with external ticket number",
+        "description": "[Link to my ticket](http:\/\/my-ticketing-system\/1234)",
+        "date_creation": "1434227446",
+        "color_id": "yellow",
+        "project_id": "1",
+        "column_id": "1",
+        "owner_id": "0",
+        "position": "4",
+        "is_active": "1",
+        "date_completed": null,
+        "score": "0",
+        "date_due": "0",
+        "category_id": "0",
+        "creator_id": "0",
+        "date_modification": "1434227446",
+        "reference": "TICKET-1234",
+        "date_started": null,
+        "time_spent": "0",
+        "time_estimated": "0",
+        "swimlane_id": "0",
+        "date_moved": "1434227446",
+        "recurrence_status": "0",
+        "recurrence_trigger": "0",
+        "recurrence_factor": "0",
+        "recurrence_timeframe": "0",
+        "recurrence_basedate": "0",
+        "recurrence_parent": null,
+        "recurrence_child": null
+    }
+}
+```
+
 ### getAllTasks
 
 - Purpose: **Get all available tasks**
@@ -3542,9 +3605,8 @@ Response example:
     - **project_id** (integer, required)
     - **task_id** (integer, required)
     - **filename** (integer, required)
-    - **is_image** (boolean, required)
     - **blob** File content encoded in base64 (string, required)
-- Result on success: **true**
+- Result on success: **file_id**
 - Result on failure: **false**
 - Note: **The maximum file size depends of your PHP configuration, this method should not be used to upload large files**
 
@@ -3554,12 +3616,11 @@ Request example:
 {
     "jsonrpc": "2.0",
     "method": "createFile",
-    "id": 1035045925,
+    "id": 94500810,
     "params": [
         1,
         1,
         "My file",
-        false,
         "cGxhaW4gdGV4dCBmaWxl"
     ]
 }
@@ -3570,8 +3631,8 @@ Response example:
 ```json
 {
     "jsonrpc": "2.0",
-    "id": 1035045925,
-    "result": true
+    "id": 94500810,
+    "result": 1
 }
 ```
 
@@ -3720,3 +3781,34 @@ Response example:
     "result": true
 }
 ```
+
+### removeAllFiles
+
+- Purpose: **Remove all files associated to a task**
+- Parameters:
+    - **task_id** (integer, required)
+- Result on success: **true**
+- Result on failure: **false**
+
+Request example:
+
+```json
+{
+    "jsonrpc": "2.0",
+    "method": "removeAllFiles",
+    "id": 593312993,
+    "params": {
+        "task_id": 1
+    }
+}
+```
+
+Response example:
+
+```json
+{
+    "jsonrpc": "2.0",
+    "id": 593312993,
+    "result": true
+}
+```