server/posts/upload: Add youtube-dl functionality

allows for video-based posts to be created by using youtube-dl
on the server. Access is controlled with the 'uploads:use_downloader'
permission.

1 files changed, 4 insertions, 1 deletions

diff --git a/doc/API.md b/doc/API.md
index 6a733f7..528b665 100644
--- a/doc/API.md
+++ b/doc/API.md
@@ -145,7 +145,10 @@ way. The files, however, should be passed as regular fields appended with a
 `Url` suffix. For example, to use `http://example.com/file.jpg` in an API that
 accepts a file named `content`, the client should pass
 `{"contentUrl":"http://example.com/file.jpg"}` as a part of the JSON message
-body.
+body. When creating or updating post content using this method, the server can
+also be configured to employ [youtube-dl](https://github.com/ytdl-org/youtube-dl)
+to download content from popular sites such as youtube, gfycat, etc. Access to
+youtube-dl can be configured with the `'uploads:use_downloader'` permission
 
 Finally, in some cases the user might want to reuse one file between the
 requests to save the bandwidth (for example, reverse search + consecutive