Skip to navigation

Accepts one UTF-8 Markdown file and returns its converted Doc content HTML.

The response contains converted content only. The caller decides whether to append it to or replace the target Doc, then saves the result through the normal document update flow. This endpoint does not save content or update live editing.
Required Permissions
The user must have at least write permission for the specified document.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

documentIdstringRequiredformat: "uuid"
The target Doc ID. It scopes document links restored during conversion and the write permission check.

Request

This endpoint expects a multipart form containing a file.
contentfileRequired

The required UTF-8 Markdown file.

Response

OK
idstringOptionalformat: "uuid"
The id of the document.
contentstring or nullOptional
The content of a document's current version.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error