documents

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

Changed on

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. <Check title="Required Permissions" icon="key">The user must have at least write permission for the specified document.</Check>

post/documents/{documentId}/content/convertmarkdown

Request

  • Base URL: https://api.awork.com/api/v1
  • URL: https://api.awork.com/api/v1/documents/{documentId}/content/convertmarkdown
  • Auth: HTTP bearer

Path parameters

documentIdstring uuid required

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

Request body multipart/form-data

contentstring binary required

The required UTF-8 Markdown file.

Response

OK

idstring uuid

The id of the document.

contentstring nullable

The content of a document's current version.

Changes