diff --git a/rest-api.md b/rest-api.md
index 6d22f13..01dd268 100644
--- a/rest-api.md
+++ b/rest-api.md
@@ -254,6 +254,25 @@
 
 In above example, the file foo will be saved with the name bar on the BMC.
 
+The operation will either return the version id (hash) of the uploaded file
+on success:
+
+    {
+        "data": "ffdaab9b",
+        "message": "200 OK",
+        "status": "ok"
+    }
+
+or an error message:
+
+    {
+        "data": {
+            "description": "Version already exists or failed to be extracted"
+        },
+        "message": "400 Bad Request",
+        "status": "error"
+    }
+
 ## Event subscription protocol
 It is possible to subscribe to events, of interest, occurring on the BMC. The
 implementation on the BMC uses WebSockets for this purpose, so that clients