Skip to content

by Startups.Studio

OverviewStartup

Startup.launch

POST /{namespace}/startups/{startup}/launch

Launch puts a Startup live on its domain, serving its Offers to Customers.

Noun: Startup
Mode: do
Event: Startup.launched

You, to your agent

Launch QuietCopy.

curl -X POST https://api.sb/quietcopy.com/startups/startup_1/launch \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"

import { $ } from 'startup-builder'

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

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

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

Inputs

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

Outputs

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

Effects

Emits Startup.launched.
Performed by the Founder.
Runs the entry checks of Live, and refuses when any check fails.
Sets launchedAt on the Startup.

Refuses when

Check	Error	Fix	Then call
Offers published (`live-offers`)	`refused`	Publish an Offer with a price and terms.	Offer.publish
Work defined (`live-work`)	`refused`	Give every published Offer a Workflow with each step assigned.	Workflow.create
People assigned (`live-people`)	`refused`	Seat an Agent or a person in every Role the Workflows need.	Role.staff
Site published (`live-site`)	`refused`	Publish the home, pricing, terms, and privacy Pages.	Version.deploy
Test run passed (`live-test-run`)	`refused`	Have a sample Customer accept every published Offer in test.	Offer.accept
Portal ready (`live-portal`)	`refused`	Build the Startup so the Portal serves every Customer record.	Startup.build
Agent API open (`live-agent-api`)	`refused`	Build the Startup and fix each conformance failure it names.	Startup.build
Payouts connected (`live-payouts`)	`refused`	Have a person claim the Startup and finish payouts onboarding.	Startup.claim
Address resolves (`live-address`)	`refused`	Connect the Domain, wait for its certificate, and check `walletsEnabled`.	Domain.connect
Five slots at Commitment (`live-slots`)	`refused`	Run the cheapest test on each slot below Commitment, such as a fake door on the reserve page.	Experiment.start
Sources secured (`live-sources`, Dataset API, Directory only)	`refused`	Record a licensed, crawled, or synthetic Source for every Dataset.	Source.create
Evals passing (`live-evals`, Agent as a Service only)	`refused`	Run the Evals again after fixing each failing task type.	Action.evaluate
SLA published (`live-sla`, Services-as-Software, E2E managed service only)	`refused`	State the outcome, the SLA, and the remedy on every service Offer.	Offer.publish
Supply seeded (`live-supply`, Marketplace, Licensed-human marketplace only)	`refused`	Onboard the first Suppliers and have each accept the supplier terms.	Human.onboard
Credentials verified (`live-credentials`, Licensed-human marketplace only)	`refused`	Verify a current credential for each Supplier in each jurisdiction served.	Credential.verify
Human steps staffed (`live-human-loop`, E2E managed service only)	`refused`	Seat a person in every human delivery step, with a response time.	Role.staff
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.launch

When it waits

Gate	Default
Decision class	Medium: two-way, visible
Delay window	1 business hour, in which a watcher can pause, redirect or cancel it; then it runs.
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`.

An Agent launches a Startup once its site and first Offer are ready, and Customers can accept that Offer from then on.