Create a new backend app with isolated database and API endpoints.
Returns: app_id, api_url, url (frontend URL), and provisioning status.
Example:
Input: { name: "my-blog" }
Output: {
app_id: "app_abc123",
api_url: "https://api.butterbase.dev/v1/app_abc123",
url: "https://my-blog.butterbase.dev",
_meta: { next_actions: [...] }
}
URL guide:
- api_url: Your API endpoint for database queries, auth, and functions (e.g. https://api.butterbase.dev/v1/app_abc123)
- url: Your frontend URL where your deployed site is served (e.g. https://my-blog.butterbase.dev)
- These are different! The api_url is for backend requests, the url is where users visit your app.
Next steps: Use manage_schema (action: "apply") to define tables, then manage_oauth (action: "configure") for auth.
Common errors:
- Name already exists: Choose a different name or use manage_app (action: "list") to find existing app
- Invalid characters: Use only lowercase letters, numbers, hyphens, underscores
- Name too long: Maximum 63 characters
The response includes _meta.next_actions with recommended next steps.