Create Document

Start a document's history with a file as its first version; an edit of a file is kept as a version only once the file is one. Send the file's bytes as multipart/form-data in the file field, or name a file you uploaded (or an edit's files.clean) by file_id, as a form field or a JSON body: the first version is that file as it is, so its listing and paragraph ids stay the ones you read. Each upload starts a new document; a file named by file_id becomes a version once, and naming it again is 409 CONFLICT. An edit's files.clean can be named while the edit is still being applied; one whose edit failed is refused.