Commerce
launchApp
Launch App
Run an app from ONE SENTENCE to a reviewed Exchange listing, filing every step on one Task row and stopping at the consent gates.
Arguments
appIdstringoptionalAdopt a Studio app the owner already has instead of creating one. Must be an app they own. Omit and the launch creates its own.appSpaceIdstringoptionalWhich Space (from listPageSpaces) the Studio app is filed in. A different id from spaceId, which is the Space team that owns the money. Omit to leave the app in the owner's Studio library.cadencestringoptionalHow the money is asked for: "one_time" sells the listing once, "month" or "year" takes a Space membership. Omit for a free launch.connectionIdstringoptionalThe Stripe connection (from listSpacePaymentAccounts) to name in the binding step of the directive. Nothing is bound here; the owner makes that call.intentstringoptionalWhat the listing is: "demo" (a finished thing, the default) or "template" (a starting point a buyer makes their own).launchIdstringoptionalResume the launch filed under this Task row. Omit on the first call; the answer carries it.machineIdstringoptionalWhich machine the Builder lane runs on (machineId from listMachines). Omit only when exactly one machine is active.offerIdstringoptionalAdopt an Offer the owner already drafted instead of creating one. Omit and a priced launch creates its own private draft.priceCentsintegeroptionalPrice in cents, e.g. 500 = $5.00. Omit for a free launch.sentencestringoptionalThe app in one sentence, in the owner's own words. Required unless launchId is given.spaceIdstringoptionalThe Space team id that owns the money: the offer is created on it and the Stripe binding in the directive names it. Required before a priced launch can create its offer.
Returns
The steps are created, building, built, gated, submitted, approved, and every return says which step it is on, what it did, and what to do next.
Declared limits
priceCents: greater than 0priceCents: maximum 9007199254740991
Ask for it
The Cloud routes these requests to this verb.
- build and list this app
- take this idea to the store
- launch an app that does X
- resume my launch
Pair it with
The verbs that finish the job.