startCustomAppAuthoring

Mutation

Starts one server-bound App Studio authoring thread and dispatches Buzz to build the app. Returns once the run is dispatched, not once the app is built: poll getBuzzMessages with the returned thread _id for Buzz's reply and its build tool results, and getCustomAppVersions for the new version and its buildStatus. requestId is the client-generated thread id and makes the call idempotent — repeating it re-enters the same thread instead of starting a second one. initialPrompt may carry code verbatim: it is HTML-escaped, not stripped, and one longer than 1,000,000 characters of escaped text is refused rather than truncated, so a brief is never quietly shortened before Buzz builds from it. Use continueCustomAppAuthoring for every turn after the first. Access: authenticated member of an App Studio workspace with Buzz enabled. Errors: workspace without App Studio, disabled Buzz, invalid workspace access, a requestId that belongs to another thread, a missing initialPrompt for a new thread, an initialPrompt that contradicts the one the thread already started from, or an initialPrompt over the length ceiling.

Returns BuzzThread !.