With the Lovable API, your app can:
- List workspace details and projects, and read project details
- Update project settings and delete projects
- Publish or unpublish projects, track deployment status, and update publish settings
- Embed a project’s built preview in your app with short-lived embed URLs
- Read project traffic analytics and workspace-level analytics
- Read code security scans and their findings
- Read management data such as members, groups, and security insights
Common use cases and example apps
These examples show what you can build with the Lovable API, each with a prompt to start from.How to connect the Lovable API
The Lovable API connector is only available on Business and Enterprise plans.
Prerequisites
Before connecting the Lovable API, make sure you have:- A Lovable workspace on a Business or Enterprise plan that you want your app to manage. It can be the workspace you build in or a different one.
- An admin or owner role in the workspace you want your app to manage, so you can create the API key during the connector setup. You don’t need a key in advance. If you’re not an admin or owner, ask one to create a key in that workspace’s Settings → Access tokens, then paste it in during setup. That’s also the way to manage a different workspace or to control the key’s scopes and expiration. Two reads, a project’s PII labels and the per-project security inventory, require an Enterprise workspace.
- Permission to create connections in the workspace where you build your app (see Who can create connections and clients)
All requests made through this connector act on the connected workspace and are attributed to the person who created the API key. Requests are limited to what that person can access, with the access granted to the key. Plan-gated endpoints and any credits spent through the key follow the connected workspace’s Lovable plan.
Add the connection in Lovable
Add the connection in the workspace where you build your app. The connection needs a Lovable API key, which is scoped to one workspace: the form can create one for the workspace you build in, or you can paste an existing key for the workspace you want your app to manage.1
Open Lovable API in Connectors
Open Connectors and select Lovable API. For the other places to open the catalog from, see Where to find connectors.
2
Add a connection
Click Add connection.
3
Configure the connection
-
Display name: name the connection, for example
Acme workspace. This name is only used inside Lovable to identify the connection. -
API key: under Create API key, enter a Key name (for example
Automation) and a Monthly credit cap, then click Create key. Lovable creates a workspace API key with Read & write access to Projects and Read access to Workspace, capped per calendar month, and fills in the API key field. You can raise the cap later in Settings → Access tokens.
lov_. See Create and manage API keys for how to create one.4
Choose who can use this connection
Under Sharing, the connection is private to you by default and shows a Private label. To share it, click Share with others. Then add workspace members by email, or click Invite entire workspace to make the connection available to everyone in your Lovable workspace.See Who can use connections and clients for more information.
5
Connect
Click Connect. Lovable verifies the key against the Lovable API before saving the connection.
Limitations
The Lovable API connector is management-only. It cannot:- Send chat or build messages to the Lovable agent, on any connection. To build or edit apps, use the Lovable editor or the Lovable MCP server instead.
- Create or remix projects. Create them in the Lovable editor or through the Lovable MCP server.
- Work with a project’s code files, git history, or database, or manage its knowledge and skills.
- Support per-end-user Lovable login. Each connection represents a single Lovable account shared across all projects linked to it.
Manage your Lovable API connection
Connections are managed from Connectors: select Lovable API, then open the connection.- Unlink projects to remove Lovable API access from specific projects while keeping the connection available for others. See Unlink projects from a connection for the steps.
- Delete the connection to remove it from the workspace entirely. Deleting is permanent. It removes the credentials from all linked projects, and app features that use Lovable API stop working until a new connection is added. See Delete a connection for the steps and who can delete.