Skip to main content
POST
Build
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 on the web. 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 to prepare a saved revision.

Authorizations

x-api-key
string
header
required

Headers

Idempotency-Key
string
required

Stable key for this exact mutation. Reusing it with different input returns 409.

Required string length: 1 - 200

Body

application/json
action
string
required
Allowed value: "list_templates"

Response

Current owner-scoped result. A mutation retry returns its saved response.

Action-specific private draft, job, validation, import or export result.

Last modified on November 7, 2026