Skip to content
Get Started

API

Settings API

On this page

{workspace} is the workspace slug. {app} is the app UUID. A person who is not a member receives 404.

GET /workspaces/{workspace}/apps/{app}/settings

  • Auth: signed-in member.
  • Name: app.settings
  • Request: none.
  • Response: the app settings page, including the allowed stacks. This visit is stored as the last app.
  • Errors: 404 when the app is missing, deleted, or in another workspace.

PATCH /workspaces/{workspace}/apps/{app}

  • Auth: signed-in developer, admin, or owner.
  • Name: app.update
  • Request: name (required, max 100), description (optional, max 500), icon (optional image, png, jpg, jpeg, or webp, max 2048 KB), platform (ios, android, both, or web), stack (Expo, React Native, Flutter, Swift, Kotlin, Web, or Other), package_name (optional reverse-DNS identifier, required for Kotlin), bundle_id (optional reverse-DNS identifier). For React Native, Flutter, and Other, the saved platform follows the configured sides. The posted platform is not used.
  • Response: redirect to app settings. A new icon replaces the stored one. Omitting the file leaves the current icon in place. Clearing the last configured side on React Native, Flutter, or Other sets the environment back to development.
  • Errors: 403 for a viewer. 404 when the app is missing or in another workspace. Validation errors redirect back.

Workspace people, usage, and billing are documented in workspaces.