SDK
New: AI Gateway module for calling Base44’s managed AI models
base44.aiGateway.connection() returns a baseURL and token you can pass to any OpenAI-compatible client (like the openai SDK or the Vercel AI SDK) to call Base44’s managed AI models directly from your own backend function code, including as part of tool-using agents, without a separate account or API key with the underlying model provider.- AI Gateway module: Authentication modes, billing and limits, and usage examples.
Backend Functions
New: Runtime API and default-export handlers for backend functions
Backend functions can now import a built-inbase44:runtime module with no installation needed. Use waitUntil() to run background work like logging or notifications after your function has already responded, and secrets.get() to read app secrets at runtime. Functions can also export their handler as the default export.- Backend functions overview: Runtime API for background work and reading secrets, plus the default-export handler pattern.
CLI
New: Global --json flag
Pass --json on any Base44 CLI command to output the result in JSON.When included, commands such as workspace list, connectors list-available, and logs return structured JSON.- Global flags: Flags available for all commands
SDK
New: Square connector
The Square connector is now available for connecting your Base44 app to Square.- connectors (SDK): Updated connector list with Square.
Backend Functions
New: Multi-file backend functions and shared code
Backend functions are no longer limited to a singleentry.ts. Split a function’s logic across multiple files and import them with relative paths, or place code in a base44/shared/ directory to reuse it across every function in your project.- Multiple files per function: Split a function’s logic across files in its directory.
- Share code between functions: Reuse code across functions with a
base44/shared/directory.
CLI
New: Workspace targeting in the CLI
Manage multi-workspace apps directly from the CLI. List every workspace you belong to, look up a single workspace by ID, and move an app from one workspace to another. New apps can also be created directly into a specific workspace with a new-w, --workspace <id> flag on create and link --create, instead of landing in your personal workspace.workspace list: List the workspaces you belong to, with a--rolefilter.workspace get: Show details for a single workspace by ID.workspace move: Move an app to another workspace.createandlink --create: New--workspaceflag to create an app in a specific workspace.
SDKBackend
Updated: asServiceRole bypasses entity access rules
When you use base44.asServiceRole in a Base44-hosted backend function, entity access rules and field-level security do not apply. The client reads and writes any record in any entity, without needing a matching admin rule on the entity. Use it for trusted backend logic. If your function needs access checks, you’re responsible for enforcing them yourself.- Service role data access: Updated behavior and example.
createClientFromRequest(): Service role client.
CLI
New: Global --app-id flag for logs, exec, and other app-scoped commands
You can now target any Base44 app on your account without leaving the current directory. App-scoped commands accept a global --app-id <id> flag (or BASE44_APP_ID environment variable), so commands like logs and exec work against apps you built in the Base44 online app editor and never linked locally.- Select a target app: Resolution order for
--app-idandBASE44_APP_ID. logs: Fetch logs for any app from anywhere on your machine.exec: Run scripts against any app from anywhere on your machine.
CLI
Updated: base44 dev starts your frontend too
When your project defines site.serveCommand in base44/config.jsonc, base44 dev now spawns your frontend dev server alongside the local backend and manages both processes together. The CLI injects VITE_BASE44_APP_ID and VITE_BASE44_APP_BASE_URL into the frontend environment, streams both processes’ output to the same terminal, and tears them down together on Ctrl-C.dev: Frontend dev server lifecycle.- Local development setup: Updated walkthrough.
CLI
Updated: Private and workspace apps can be run locally
base44 dev now supports running private and workspace-restricted apps locally. Previously, these apps failed at the auth gate during local development.SDKBackend
Updated: InvokeLLM model options
The SDKInvokeLLM model property now supports Claude Opus 4.8.
Additionally, the "gpt_5" parameter has been deprecated. By default, calls that pass "gpt_5" are mapped to "gpt_5_4".- SDK integrations module: Updated
InvokeLLMParamsmethod properties.
SDKBackendConnectors
Updated: New Connectors
4 new connectors are now available: Google Ads, Databricks, QuickBooks, and Snowflake.- Connectors: Updated connector table with all type identifiers.
- SDK connectors module: Updated connector list for
getConnection().
BackendAutomations
Updated: Supported automation integrations and events for connector automations
The connector automations reference now includes new webhook events for Slack Bot and Wix.- Automations: Supported integrations, events, and trigger condition requirements.
App Code
New: Redesigned Code changes modal
The Code changes modal has been redesigned with a full file tree, diff stats bar, and color-coded file states. Developers can now review every file the AI added, modified, or deleted — grouped by folder with side-by-side diffs — before publishing changes.- Code Tab: How to open the modal, navigate the file tree, and read diffs.
Backend
New: Workspace API key audit events
The audit log now records lifecycle events for workspace API keys. Developers can query forworkspace.api_key.created, workspace.api_key.updated, workspace.api_key.disabled, workspace.api_key.enabled, and workspace.api_key.deleted events, each including key_id, key_name, and key_prefix metadata for identification without exposing secrets.- Event Types: Full event reference including workspace API key events and their metadata fields.
Backend
Updated: Credit pools and per-member limits in Monitoring API
The Monitoring API overview now documents the credit pool model introduced in v1.1: workspace-level credit pools, per-member credit limits, and over-limit flags. TheGet analytics response includes a credit_pool object with tier, limits, and usage data, and each user record includes a member_allocation object. The legacy seats and seat_type fields are deprecated in favor of credit_pool and member_allocations.- Monitoring API overview: Credit pools, per-member limits, deprecation notices, and over-limit workflow.
SDKBackend
New: App-user connectors SDK module
The newbase44.connectors module lets you manage per-user OAuth connections from frontend code. Call connectAppUser(connectorId) to start the OAuth flow and receive a redirect URL, and disconnectAppUser(connectorId) to remove a user’s stored token. The backend connectors page now documents both app-scoped and app-user connection models.- SDK user-connectors reference:
connectAppUser()anddisconnectAppUser()methods. - Connectors: App-user connectors setup and usage.
BackendBackend Functions
New: Connector automations
Backend functions can now trigger automatically in response to webhook events from connected services such as Gmail, Google Calendar, Google Drive, Microsoft Outlook, Microsoft OneDrive, Slack, Microsoft Teams, and SharePoint. Configure connector automations infunction.jsonc alongside your other automations, with optional trigger conditions to filter events before your function runs.- Automations: Full field reference, supported integrations and events, trigger conditions, webhook payload structure, and examples.
- Connectors: Overview and cross-reference.
CLIAuth
New: auth social-login command
The new auth social-login command lets you enable or disable social identity providers (Google, Microsoft, Facebook, and Apple) in your app’s local auth config. Google supports custom OAuth credentials via --client-id and --client-secret flags. Run auth push or deploy to apply changes.auth social-login: Enable or disable social login providers in local config.- Auth config reference: New config fields for all four social providers, including
googleOAuthModeandgoogleOAuthClientId.
SDKEntities
Updated: Enhanced entity filtering with array shorthand and query operators
entities.filter() now accepts the EntityFilterQuery<T> type for its query parameter, enabling array shorthand to match any of a set of values, null to match null fields, and MongoDB-style query operators ($gte, $in, $or, and others) for advanced filtering logic.- SDK entities module: Updated
queryparameter type and new filtering examples.
SDKAgents
Updated: waiting_for_user_input added to agent tool call status
Agent tool calls now include "waiting_for_user_input" as a valid status value. Update any code that checks or switches on the status field of tool call objects to handle this new state.- SDK agents module: Updated
statustype on tool call objects.
SDKApp Code
New: GPT-5.5 and Claude Opus 4.7 available in InvokeLLM
Two new model options are now available forintegrations.Core.InvokeLLM(): "gpt_5_5" (GPT-5.5) and "claude_opus_4_7" (Claude Opus 4.7). Pass either value in the model parameter to override the app-level model for a specific call.- SDK integrations module: Updated
InvokeLLMParamsmodel options.
SDKBackend
Updated: New OAuth connectors
BambooHR, Calendly, Contentful, GitLab, Google Meet, Google Tasks, Hugging Face, Instagram, and Supabase are now available as OAuth connectors. Use their type identifiers inconnectors.getConnection() and in backend function connector calls.- Connectors: Updated connector table with all type identifiers.
- SDK connectors module: Updated connector list for
getConnection().
SDKAgents
New: getTelegramConnectURL()
agents.getTelegramConnectURL() generates a URL that connects an end user to an agent via Telegram.- SDK agents module:
getTelegramConnectURL()method.
Audit Logs API
Deprecated: Seat management removed from Audit Logs
Theworkspace.member.seat_updated audit log event type has been removed, along with its associated new_seat_type and old_seat_type metadata fields.- Audit log event types: Updated event type reference.
CLIBackend
Updated: Email/password auth in local development
Thebase44 dev server now handles email/password registration and login locally, including OTP verification (codes print in your terminal instead of email). OAuth and social login still forward to Base44.- Local development: Authentication section and token behavior.
- Troubleshooting: Local dev tokens versus production.
Backend
New: Audit Logs API
The Audit Logs API provides workspace-scoped access to audit events for security monitoring, compliance, and SIEM integrations. Use it to stream events into your SIEM, investigate user activity across all apps in a workspace, and build compliance reports with full event detail.- Audit Logs API Overview: Introduction and workspace ID setup.
- Authentication: Required role and API key usage.
- Event Types: Full list of 65 event types across 13 categories.
- Rate Limits: Request limits and throttling behavior.
CLI
New: auth commands
Manage your app’s authentication settings from the CLI. Pull the current config, toggle login methods like email/password, and push changes to your live app.auth pull: Fetch auth config from Base44auth password-login: Enable or disable password loginauth push: Push auth config to Base44- Managing login and registration: Dashboard equivalent
BackendEntities
Updated: User entity now runs locally in the dev server
On startup, the dev server seeds a single user record from your authenticated CLI credentials. Read and update operations onme work as they do in production; create and delete requests are silently ignored, matching production behavior.- Local development: Updated entity behavior details.
CLI
New: exec command
Run standalone TypeScript or JavaScript scripts with the Base44 SDK pre-authenticated as the current user. Useful for data migrations, seed scripts, ad-hoc queries, and automation.exec: Command reference- Standalone scripts: Full guide with use cases and examples
SDKBackend Functions
SDKEntities
New: Bulk update methods for entities
Two new methods on entity handlers for updating multiple records at once:updateMany(): Applies the same update to all records that match a query. Supports MongoDB query operators for filtering and update operators.bulkUpdate(): Updates multiple specific records in a single request, each with its own data.
CLIBackend Functions
New: functions list, functions delete, and functions pull commands
Three new CLI commands give you full control over deployed backend functions from the terminal. Use functions list to see all deployed functions, functions delete to remove one or more by name, and functions pull to download remote functions to your local project. The functions deploy command has also been updated to support selective deployment by name and a --force flag that removes remote functions not present locally.functions list: List all deployed backend functions.functions delete: Delete one or more deployed functions by name.functions pull: Download deployed functions to your local project.functions deploy: Updated reference with selective deploy and--forceflag.
CLI
New: connectors list-available command
List all integration types supported by Base44 directly from the terminal. The command displays each connector’s type identifier, description, and any required connection configuration fields.- connectors list-available: Command reference.
BackendSDK
New: 11 new OAuth connectors and Stripe managed provisioning
Eleven new OAuth connectors are now available: Airtable, Dropbox, Google Classroom, Google Search Console, Linear, Microsoft Teams, Outlook, SharePoint, Splitwise, and Wix. Stripe is also supported via a new managed provisioning flow — no OAuth required. UseSTRIPE_SECRET_KEY from the environment to call the Stripe REST API directly in backend functions.- Connectors: Updated guide with the full connector table, Stripe provisioning details, and usage examples.
- connectors (SDK): Updated reference table with all new type identifiers.
SDK
Updated: InvokeLLM now accepts a model parameter
The integrations.Core.InvokeLLM method now accepts an optional model parameter to override the app-level model setting for a specific call. Supported values include gpt_5, gpt_5_mini, gemini_3_pro, gemini_3_flash, claude_sonnet_4_6, and claude_opus_4_6.- integrations: Updated SDK reference with the new
modelparameter.
CLI
Updated: create command arguments and flags
The base44 create command now accepts the project name as a positional argument (base44 create [name]) instead of a -n, --name flag. The -d, --description flag has been removed. A new --no-skills flag lets you skip AI agent skills installation during project creation.create: Updated command reference with new argument and flag list.
Backend FunctionsCLI
Updated: function.jsonc is now optional
Backend functions no longer require a function.jsonc configuration file. Create a function with only an entry.ts or entry.js file. Add function.jsonc only when you need a custom name or automations.- Backend Functions: Updated overview with simplified setup and optional config file details.
- Project Structure: Updated to reflect that
function.jsoncis optional.
CLI
New: dev command for local development
Run backend functions, entities, and media uploads on your machine with base44 dev.- Local development: Full guide with supported features and limitations
dev: Command reference
Connectors
New connectors: Box, ClickUp, Google Analytics, Wrike
Four new OAuth connectors are now available. Configure them with the CLI and callgetConnection() in your backend functions.- Connectors: Full list of supported services.
- connectors (SDK): Reference table with all type identifiers.
SDK
New: getConnection() method for connectors
The new connectors.getConnection() method returns both an accessToken and a connectionConfig object with connector-specific parameters (e.g. a subdomain or account ID). This replaces getAccessToken(), which is now deprecated.- Connectors: Updated examples and usage guide.
- connectors (SDK): Full method reference.
SDK
New: SSO authentication provider
Theauth.loginWithProvider() method now supports 'sso' as a provider, enabling enterprise SSO login flows. Enable SSO in your app’s authentication settings before using this provider.- auth (SDK): Updated provider list and SSO code example.
BackendSDK
New: Discord, GitHub, Google BigQuery, and Slack Bot connectors
Four new connector types are now available:discord, github, googlebigquery, and slackbot. The slackbot connector uses a bot token instead of a user token, letting your app post as a custom bot with its own display name and icon. The SDK reference now includes a full connectors table, ConnectorIntegrationType type definitions, and a Slack Bot code example.- Connectors: Full list of supported services and configuration reference.
- connectors (SDK): Available connector types, Slack Bot example, and
ConnectorIntegrationTypetype definitions.
AgentsCLI
Updated: Base44 Skills — New Troubleshooter Skill and Global Installation
Base44 skills now include a dedicated troubleshooter skill for investigating production issues by fetching and analyzing backend function logs. Skills can also be installed globally withnpx skills add base44/skills -g for use across all projects. Full documentation for all three skills (base44-cli, base44-sdk, base44-troubleshooter) is now available.- Base44 Skills: All available skills, capabilities, example prompts, and installation instructions.
CLIBackend
New: connectors pull command
Pull connector configurations from Base44 to local JSONC files. Downloads all connectors and syncs them to your project’s connectors directory.connectors pull: Pull connector configurations from Base44 to local files
CLI
CLIBackend Functions
New: Secrets management
Manage project secrets from the CLI. Secrets are available to your backend functions as environment variables viaDeno.env.get().secrets set: Set one or more secrets from KEY=VALUE pairs or an.envfilesecrets list: List configured secrets, values are maskedsecrets delete: Delete one or more secrets
BackendAgents
New: Base44 MCP Server
The Base44 MCP server (app.base44.com/mcp) lets AI assistants create and manage your apps via OAuth. Supports creating apps, editing apps, listing apps, and querying entity data.- Base44 MCP server: Connect your AI assistant, available tools, and example prompts.
CLIBackendBackend Functions
App Code
New: Disconnect Your App from GitHub
You can now disconnect a Base44 app from its GitHub repository or remove your GitHub account connection from Base44 entirely. Use this when you want to stop syncing code changes or switch to a different repository. Note that after disconnecting an app, you’ll need to use a different repository name to reconnect.- GitHub Integration: How to connect, sync, and disconnect your app from GitHub.
SDKAuthentication
New: Sign in with Apple
Apple is now a supported authentication provider. Users can now sign in to your Base44 apps using their Apple ID alongside existing providers like Google, Microsoft, and Facebook.- Enable Apple in your app’s authentication settings before using this provider.
- Use
loginWithProvider('apple')to initiate Apple OAuth login. - Learn more: Authentication Features
SDKCLIEntities
New: TypeScript Type Generation
Generate TypeScript types from your backend resources for full type safety and autocomplete in your SDK code. The newtypes generate command creates typed interfaces for entities, function names, and agent names.types generate: Generate TypeScript types from your project resources.- Dynamic Types: Learn how to use generated types for type-safe entity operations, autocomplete for functions and agents, and better IDE support.
- Updated SDK types: All entity CRUD methods now return properly typed results instead of
any.
BackendCLI
New: OAuth Connectors
Connect your Base44 apps to third-party services with OAuth integrations. Define connector configurations in your project and authorize services to make authenticated API calls from your backend functions.- OAuth Connectors: Define and deploy OAuth integrations with supported services.
connectors push: Push connector configurations and authorize OAuth flows.
App Code
Updated: GitHub Integration Now Available for Shared Workspaces
GitHub 2-way sync is now available for apps in shared workspaces. Previously limited to personal workspaces, you can now connect shared workspace apps to GitHub for local development with automatic synchronization.- For apps in shared workspaces, only app owners can perform the initial connection to a repository.
- App owners or the user who originally connected the repository can reconnect if there is a connection issue.
CLIBackend
New: Eject Command
Eject an existing Base44 app to a local project. Work on your app in your own IDE with full code control instead of through the Base44 interface.eject: Download frontend code and backend resources from an existing app to a new local project.- Start from an Existing Base44 App: Step-by-step guide to eject and set up your local project.
BackendBackend FunctionsAutomations
New: Automations for Backend Functions
Run backend functions automatically on a schedule or in response to database events. Define automations in your function configuration files and deploy them with the CLI.- Automations: Schedule functions with cron or simple intervals, or to trigger on entity events.
functions deploy: Deploy backend functions with their automations using the CLI.
BackendAgents
New: Base44 Docs MCP Server
Connect AI assistants like Cursor, Claude Desktop, and VS Code to Base44 documentation. Ask questions about the SDK, CLI, entities, or any Base44 feature and get answers with links to the relevant docs.- Docs MCP Server: Setup instructions and example queries.
CLIAgents
New: CLI Agent Configuration
Define AI agents using local configuration files. Create JSONC configuration files in yourbase44/agents/ directory and sync them to Base44 with the CLI.- Agent Configuration: Define agents with custom instructions, model selection, and tool access.
agents pull: Pull agent configurations from the cloud to your local project.agents push: Push local agent configurations to Base44.
BackendEntities
New: User Schema Reference
The built-in user entity reference for authentication and user management in your Base44 apps.- User Schema: Built-in user entity fields, authentication, and configuration.
App Code
Updated: Code Tab
View all project files directly in the Base44 editor Code Tab.- Project Structure: Updated file visibility in the Code Tab.
SDKAgents
New: AI Agent Extensions
Extend AI agent capabilities in external tools like Claude, Cursor, and other AI coding assistants. Use Base44 skills to give AI agents access to your app’s entities and backend functions.- Coding Agent Extensions: Skills specification, usage, and links to the Base44 skills repository.
CLIBackend Functions
New: Backend Functions in CLI
Deploy and manage server-side functions using the CLI.functions-deploy: Deploy backend functions to Base44.
BackendEntities
New: Entity System
Base44’s entity system is the foundation for custom data models in your apps. Define schemas, field types, validation rules, and security permissions.- Introduction to Entities: Schema definitions, field types, and validation.
- Security Rules: Access control and permissions.
SDKRealtime
New: Realtime SDK
Subscribe to live data changes and sync state across clients in real time.subscribe(): Subscribe to realtime entity updates via WebSocket.
App Code
New: App Code Documentation
Comprehensive documentation for working with your app code in Base44.- Introduction: Overview of app code development.
- Project Structure: Understand your app’s file structure.
- Code Tab: Edit code directly in the Base44 editor.
- Activity Monitor: Monitor app activity and logs.
- GitHub Integration: Connect your app to GitHub.
CLI
New: CLI Command Reference
Full command reference for the Base44 CLI.- CLI Introduction: Getting started with the CLI.
create: Create a new Base44 project.login: Authenticate with Base44.deploy: Deploy your app.whoami: Check current authentication.- CLI Overview: Manage entities and functions.
BackendBackend Functions
New: Backend (BaaS) Documentation
Use Base44 as a backend service for any frontend. Define entities, deploy functions, and integrate with React or other frameworks.- Introduction to Backend: Overview of Base44 backend features.
- Project Structure: Understand backend project layout.
- Backend-only Quickstart: Use Base44 as a standalone backend.
- React Quickstart: Integrate Base44 backend with React.
App Code
New: GitHub 2-Way Sync
Full version control with bidirectional GitHub synchronization. Keep your Base44 app and GitHub repository automatically in sync.- Work in your preferred IDE and sync changes back through GitHub.
- Collaborate with multiple contributors on the same app.
- GitHub Integration: Connect your app to GitHub.
SDK
New: NPM Packages
Bring any web library from NPM into your Base44 apps. Use packages like GSAP, Radix UI, anime.js, and more for animation, 3D, UI components, charts, forms, and media.- Add packages directly from the builder by prompting which package you want.
- Build apps with premium motion, advanced 3D scenes, richer dashboards, and more.