Create an App
Creates an App and reserves its address. The App’s sandbox doesn’t start, and nothing is published, until you use them. During the beta an organization can have 10 Apps.
Authorizations
Scopes
Headers
A key that identifies this request for retries, up to 200 printable characters. A retry with the same key and input returns the first request's result instead of repeating the work. If you omit the key, the API generates one and returns it in the Idempotency-Key response header.
1 - 200Body
The App's label under the App base domain. If another App has the slug, including a deleted App, or the slug is reserved, the request returns 409 slug_unavailable. Reserved slugs: staging, preview, api, www, local. If you omit it, the API generates one, such as plucky-teal-tatooine.
^[a-z0-9](?:[a-z0-9-]{0,46}[a-z0-9])?$Response
The new App.
The sandbox's state. Any request that needs the sandbox starts it, and the sandbox stops on its own when it's idle.
stopped: the sandbox isn't running.starting: the sandbox is starting.running: the sandbox is running.stopping: the sandbox is committing changes and stopping.failed: the most recent start failed. The API retries while the sandbox is needed, and any request that needs the sandbox retries right away.
stopped, starting, running, stopping, failed