Build
Private Builder preview: start_draft (idea, website or typed definition), import_package (base64 Darwin Agent ZIP), import_source, billing_summary, save_draft, get_draft, list_drafts, check_slug, validate_draft, export_draft, export_destination, start_test, get_job, resume_job and cancel_job. billing_summary also requires payments:read and returns the owner plan, credit-pack catalog, available credits and payment-method readiness. Test submission/resumption and release preparation require a usage payment method on file. Node execution rates still require a verified quote. Account-owned draft reads require builder:read; save and test mutations require builder:write. save_draft uses expectedRevision and Idempotency-Key. start_test pins a saved revision; resume_job executes supported TypeScript in a configured isolated local runner. export_draft returns a base64 Darwin Agent ZIP archive alongside structured metadata. Structural validation is not execution evidence. Legacy agent-definition actions remain compatible under their existing scopes.
POST /api/v3/build with an action:
import_source: normalize supported JSON or Markdown source without executing it.save_draft: save the full draft withexpectedRevision(0 for a new draft). Reuse the returneddraftIdand 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_jobruns it;get_jobreads it andcancel_jobcancels it.
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.Headers
Body
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
- Option 13
- Option 14
- Option 15
- Option 16
- Option 17
- Option 18
- Option 19
- Option 20
- Option 21
- Option 22
- Option 23
- Option 24
- Option 25
- Option 26
- Option 27
- Option 28
- Option 29
- Option 30
- Option 31
Response
Current owner-scoped result. A mutation retry returns its saved response.
Action-specific private draft, job, validation, import or export result.