Skip to content

by Startups.Studio

OverviewStartup

Startup.build

POST /{namespace}/startups/{startup}/build

Build provisions the Systems, Sites and Interfaces a Startup’s definition declares, and moves the Startup to Building.

Noun: Startup
Mode: do
Event: Startup.built

You, to your agent

Build RouteWise.

curl -X POST https://api.sb/routewise.dev/startups/startup_1/build \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"

import { $ } from 'startup-builder'

const startup = await $.Startup.build({ startup: 'startup_1' })

npx startup-builder do Startup.build --json '{"startup":"startup_1"}'

{
  "name": "do",
  "arguments": {
    "code": "return await $.Startup.build({ startup: 'startup_1' })"
  }
}

Inputs

Input	Type	Required	Description
`startup`	Startup	required	The Startup to build.

Outputs

Output	Type	Required	Description
`startup`	Startup	required	The Startup, now Building.

Effects

Emits Startup.built.
Performed by the Engineering Lead.
Provisions every System the Startup’s Templates include.
Moves the Startup from Idea to Building.

Refuses when

Check	Error	Fix	Then call
Template chosen (`building-template`)	`refused`	Name a Startup Template in the definition.	Startup.update
Problem stated (`building-problem`)	`refused`	Write the problem slot with its workarounds and why now.	Hypothesis.create
Brand named (`building-brand`)	`refused`	Give the Brand a name, a voice, a logo, and a theme.	Brand.update
Products declared (`building-products`)	`refused`	Set the kind of every Product.	Product.update
Three slots at Commitment (`building-slots`)	`refused`	Run the cheapest test on each slot below Commitment, such as a reserve deposit.	Experiment.start
The key is valid, but its scopes do not allow this operation.	`forbidden`	Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them.	Startup.build

When it waits

Gate	Default
Decision class	Low: two-way, nothing at stake
Delay window	None: it runs once review passes.
Limit	The call Limit of the Permission it runs under.
Over the Limit	It waits `pending` for an Approval from the Founder. Approved, it runs; refused, it ends `refused` with `limit-exceeded`; unanswered by its deadline, it ends `canceled`.