Document ssh key creation error

Add the error code returned in the headers as well as an example of the
JSON informative message returned in the body.

Signed-off-by: Loic Dachary <loic@dachary.org>

1 files changed, 16 insertions, 0 deletions

diff --git a/doc/api/users.md b/doc/api/users.md
index dd158f124de..71fa62bdd65 100644
--- a/doc/api/users.md
+++ b/doc/api/users.md
@@ -331,6 +331,22 @@ Parameters:
 }
 ```
 
+Will return created key with status `201 Created` on success. If an
+error occurs a `400 Bad Request` is returned with a message explaining the error:
+
+```json
+{
+  "message": {
+    "fingerprint": [
+      "has already been taken"
+    ],
+    "key": [
+      "has already been taken"
+    ]
+  }
+}
+```
+
 ## Add SSH key for user
 
 Create new key owned by specified user. Available only for admin