Skip to main content
The Apps API is in beta. Its endpoints and responses may change.
The Apps API lets you do from your own code what you’d otherwise do to a single app in the Base44 online app editor. Every endpoint acts on one app, identified by its ID in the URL path. Use the Apps API to:
  • Create an app and build it by sending prompts to the AI, from your own interface rather than the Base44 online app editor.
  • Follow a build as it runs, and answer questions the AI asks while it works.
  • Deploy an app to production from a CI or CD pipeline, and read the URL it is served on.
  • Publish an app’s current version, or a specific earlier saved version.
  • Download an app’s source code as a zip archive.
  • Read and change an app’s data model, and count the records and users it holds.
  • Author an app’s workflows, run them on demand, and read their run history.
  • Connect a custom domain, send email from it, and keep old links working.
  • Connect a GitHub repository and sync code in both directions.
  • Run a security scan and read its findings.
  • Query the analytics events an app tracks.
  • Generate social content and run Google Ads campaigns that promote an app.
The API reference is grouped by area. Start with the area you need.

​
API reference areas

  • Apps: Create, change, and delete an app, and manage its branding, secrets, ownership, template listings, SSO, and MCP server.
  • Code and sandbox: Read and change an app’s code, run commands in its sandbox, and manage its backend functions.
  • Chat: Build an app by sending messages to its AI chat, and answer the questions the AI pauses on.
  • Socket sessions: Open, change, and end the sessions that stream a build’s chat to a browser.
  • Checkpoints: Save, list, and restore versions of an app.
  • Deployment: Preview, publish, and unpublish an app.
  • Entities: Read and change an app’s data model and its records.
  • Users: Manage an app’s users, invitations, access requests, and shared groups.
  • Workflows: Author an app’s workflows, run them, and read their run history.
  • Agents: Read an app’s agent conversations, memories, and usage.
  • Domains and redirects: Connect a custom domain, send email from it, and redirect old URLs.
  • GitHub: Connect an app to a GitHub repository and sync code in both directions.
  • Imported app sessions: Keep an imported app’s main sandbox up to date, and run coding tasks on its repository.
  • Integrations: Connect an app to third-party accounts through connectors.
  • Security: Scan an app for security problems and act on the findings.
  • Testing: Create browser tests for an app, run them, and read the reports.
  • SEO: Read and change how an app appears to search engines and AI crawlers.
  • Analytics: Query the events an app tracks.
  • Payments: Configure Stripe and Wix Payments, and read payment analytics.
  • Marketing Agent: Set up the Marketing Agent for an app and talk to it.
  • Virality and social content: Generate social content that promotes an app, then schedule and publish it.
  • Google Ads: Run Google Ads campaigns for an app.
Three areas are a single endpoint or two, so they link straight to the reference: For how these areas relate, see Apps API concepts. For limits, see Rate limits.
Every app the API creates belongs to a workspace and its builds draw on that workspace’s credits.

​
Prerequisites

  • A personal access token. See Authentication to get one.
  • An app you can manage, and permission to take the action you are calling.

​
App ID

Endpoints that act on a specific app include the app’s ID in the URL path as app_id. To get your app ID:
  1. Go to app.base44.com.
  2. Open your app in the app editor.
  3. Copy the app ID from the editor URL: "https://app.base44.com/apps/<app_id>/editor".

​
Use the CLI

The Base44 CLI can find and call any Apps API endpoint for you. It uses the account you’re logged in to the CLI with, and it fills in the app ID from --app-id or your linked project. For example, find the operation that lists workflow runs, then call it for the failed ones:
The CLI’s api commands are:
  • api search: Search API operations by keyword.
  • api catalog: Browse operations by area.
  • api grep: Search the API spec with a regular expression.
  • api fetch: Call an operation and return the response.