Create a new doc in your Dovetail workspace. Docs are rich-text documents used to write up research reports, share findings, and publish deliverables.

You can provide the initial content as HTML, Markdown, or plain text via the content and content_type fields. Markdown support enables importing content from Confluence, Notion, and other wiki or document stores.

HTML content may include inline Dovetail nodes using the data-dovetail-type attribute — see the mention shape below for an example.

A doc can be placed inside a project (via project_id) or a folder (via folder_id), but not both. If neither is specified, the doc is created at the workspace root level.

Returns the doc object without the content body.

Inline mentions: to reference a Dovetail user, include a span with data-dovetail-type="mn" and data-dovetail-attrs='{"id":"<user-uuid>"}'. The span's inner text is used as the fallback label if the user cannot be resolved. When the id resolves to a live workspace user, the span is replaced with a live mention node on import. Unresolved ids degrade gracefully to plain text — the import does not fail.

Permissions

Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.