Open CoherenceLabs opened 2 years ago
Yeah this could definitely be improved. Unfortuantely, however, the Reference documentation is entirely generated from the Schema of the nedpoint. So we don't actually have a way right now to add custom content to those pages.
The need for that functionality has come up a couple of times, however. So it's probably worth adding support for that somehow. Just not sure what it would look like at the moment.
The REST v2
/media
endpoint reference would benefit from a mention of file content upload mechanics. The first technique documented in this gist I found (set theContent-Disposition
HTTP header field toform-data; filename="thefile.jpg"
and send the file's content as the HTTP body data) ended up working for me, but it would be helpful to have official documentation on this embedded in or linked from the/media
endpoint reference.