From: Haelwenn (lanodan) Monnier <contact@hacktivis.me>
Date: Fri, 2 Oct 2020 19:47:43 +0000 (+0200)
Subject: docs/ap_extensions.md: document uploadMedia
X-Git-Url: https://git.squeep.com/?a=commitdiff_plain;h=858dbe43607b31cba8c319755c92099cd2c9f5c1;p=akkoma

docs/ap_extensions.md: document uploadMedia
---

diff --git a/docs/ap_extensions.md b/docs/ap_extensions.md
index c4550a1ac..7d2956d6d 100644
--- a/docs/ap_extensions.md
+++ b/docs/ap_extensions.md
@@ -1,4 +1,26 @@
-# ChatMessages
+# AP Extensions
+## Actor endpoints
+
+The following endpoints are additionally present into our actors.
+
+- `oauthRegistrationEndpoint`
+- `uploadMedia`
+
+### uploadMedia
+
+Inspired by <https://www.w3.org/wiki/SocialCG/ActivityPub/MediaUpload>
+
+Content-Type: multipart/form-data
+
+Parameters:
+- (required) `file`: The file being uploaded
+- (optionnal) `description`: A plain-text description of the media, for accessibility purposes.
+
+Response: HTTP 201 Created with the object into the body, no `Location` header provided as it doesn't have an `id`
+
+The object given in the reponse should then be inserted into an Object's `attachment` field.
+
+## ChatMessages
 
 ChatMessages are the messages sent in 1-on-1 chats. They are similar to
 `Note`s, but the addresing is done by having a single AP actor in the `to`