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

# Build

> [!NOTE]
>
> Private Builder preview. Account persistence requires the Builder migration. Tests require a configured isolated runner. Generation, managed resources, and custom-component compilation are not yet connected.

Begin a private draft without signing in inside Navigator. Sign in to save it to your account. Browser drafts are local to that browser until saved.

Use `POST /api/v3/build` with an `action`:

* `import_source`: normalize supported JSON or Markdown source without executing it.
* `save_draft`: save the full draft with `expectedRevision` (0 for a new draft). Reuse the returned `draftId` and revision for edits.
* `get_draft`, `list_drafts`, `check_slug`: inspect your private drafts or check a name. Checking does not reserve a slug.
* `validate_draft`, `export_draft`: check a saved definition or export it.
* `start_test`: create a test for a saved revision and operation. `resume_job` runs it; `get_job` reads it and `cancel_job` cancels it.

Draft reads require `builder:read`; saves and test mutations require `builder:write`. Saves and starting tests require `Idempotency-Key`. Keep the key unchanged when retrying the same request. A stale revision returns a conflict instead of overwriting your work.

Tests support TypeScript without private connections, third-party dependencies, or network access in the initial isolated runner. Unsupported adapters fail explicitly. Structural validation does not prove that an operation works.

MCP exposes the same commands through `build`, with `command` and `idempotencyKey`. A component manifest is preserved in the draft; it is not proof that a custom component package has compiled or rendered.

Legacy agent-definition commands remain available with their existing resource scopes. Their `test_agent` and `test_operation` actions only validate definitions.

When ready, use [Publish](https://darwin.so/docs/studio/publish.md) to prepare a saved revision.

Use `list_templates` and `get_template` (with `slug`) to start from the shared built-in definitions. Templates preserve operation metadata but do not activate missing execution adapters. [Manage](https://darwin.so/docs/studio/manage.md) lists account drafts and prepares private updates.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.