diff --git a/README.md b/README.md
index 70d7b45..e4d393e 100644
--- a/README.md
+++ b/README.md
@@ -11,3 +11,13 @@ Change php.ini and nginx.conf settings to allow bigger uploads.
 # Todo
 
 Proper design, commit new design and updated code (when finished, in preview phase).
+
+
+# Using the API
+
+For now you can use the API like so:
+  Leaving POST value 'name' empty will cause it to save using the original filename.
+  Leaving POST valie 'randomname' empty will cause it to use original filename or custom name if 'name' is set to file.ext.
+  
+  Putting anything into POST value 'randomname' will cause it to return a random filename + ext (xxxxxx.ext).
+  Putting a custom name into POST value 'name' will cause it to return a custom filename (yourpick.ext).