diff --git a/doc/api.md b/doc/api.md
index ccd2e7a7ee..9d0dc8095b 100644
--- a/doc/api.md
+++ b/doc/api.md
@@ -393,6 +393,27 @@ Object of:
 
 ---
 
+### media/metadata/create (POST,PUT; AUTH)
+
+#### Parameters
+
+Parameters are sent as JSON object:
+
+```
+{
+  "media_id":"1234",
+  "alt_text": {
+    "text":"Here comes the description"
+  }
+}
+```
+
+#### Return values
+
+None
+
+---
+
 ### oauth/request_token (*)
 
 #### Parameters