DocumentCreate
The body that creates a document. Send name, folder_id and exactly one of key, content_base64, vimeo_id or video_url; none or two is 422. A video stores no file: mime_type, size and hash are null, and download answers 409 invalid_state. No Vimeo upload or image fetch from a URL is offered.
keystring- The storage key that `POST /documents/upload-token` returned for the uploaded file, echoed back unchanged.
content_base64string- An image as base64, raw or as a `data:image/<type>;base64,` URI, one unbroken string with no spaces or line breaks. PNG, JPEG, GIF or WebP, up to 10 MiB decoded and 50 million pixels, checked by content. A name without an extension gets the image's; a different extension is 422.
vimeo_idstring- A Vimeo video id, digits only; leading zeros are dropped and zero is refused. The document is a video that stores no file; Vimeo is not contacted. A video registers once: its id stays taken after the document is deleted.
video_urlstring- An https link to a Vimeo video on vimeo.com, www.vimeo.com or player.vimeo.com, as vimeo.com/<id> or .../video/<id>. Its id is registered as for vimeo_id. Showcase, album and channel links, and any other scheme or host, are 422.
namerequiredstring- The document's name. A name already used in the folder is numbered.
folder_idrequiredstring (uuid)- The folder to put it in. It must be a folder you can see.
descriptionstring | null- A note kept with the document.
metadataobject | null- Free-form key-value data kept with the document.