> ## Documentation Index
> Fetch the complete documentation index at: https://opentrain.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Manual

> Create a manual — a versioned page tree bound to jobs, folders, or work projects.

Creates a manual: a versioned tree of pages with a default read audience and optional bindings to platform surfaces (jobs, folders, work projects).

**Requirements:** `instructions:write` + workspace `EDITOR` or `OWNER` + a verified (claimed) account. Supports the `Idempotency-Key` header (same semantics as [Create Workspace](/docs/developers/api-reference/instructions/create-workspace)).

## Request

<ParamField path="workspaceId" type="string" required>
  The owning workspace.
</ParamField>

<ParamField body="title" type="string" required>
  Manual title.
</ParamField>

<ParamField body="defaultAudience" type="string">
  Default page audience: `ADMIN`, `CONTRIBUTOR`, `REVIEWER`, or `WORKER` (workers see the least). Pages can override it.
</ParamField>

<ParamField body="bindings" type="object[]">
  Where the manual surfaces: `{kind: "JOB" | "FOLDER" | "WORK_PROJECT", targetId, precedence}`.
</ParamField>

## Response

Returns `201` with `manual` (the summary shape) and optional `idempotentReplay`.