---
search:
  tags:
    - projects
    - POST
seo:
  description: >-
    Creates a project documentation page or folder. Omit kind for the… Reference
    for the POST /projects/documentation endpoint in the Leadtime Public API
    API.
sidebar:
  badge: POST
  label: Create a project documentation page or folder
title: Create a project documentation page or folder
type: openapi-operation
---
Creates a project documentation page or folder. Omit kind for the backward-compatible Page default.

**What to include:**
- A required title field whose value can be empty
- For a page (the default kind), a required content field whose value can be empty and optional active tag UUIDs
- For a folder, kind `Folder` with content and tags omitted
- Optional parent and sibling UUIDs to place either node in the documentation tree

**Content format:**
- Page content accepts HTML or Markdown input
- Content is automatically converted to internal ProseMirror format for storage
- Supports rich text formatting including headings, lists, tables, and code blocks
- When retrieved via GET endpoint, content is returned as HTML

**Retry safety:**
- This create operation does not accept an idempotency key
- If the outcome is unknown after a network failure, read the project tree and reconcile the intended parent, kind, and title before retrying to avoid a duplicate node

**Permissions:**
- Requires "manageDocumentation" permission and access to the project
- The new node is automatically associated with the authenticated user as the author

<Operation source="api-reference" id="projectdocumentationcontroller-createprojectdocumentation" />