Skip to main content
The Lovable connector reads your Lovable workspace from Lovable’s own API. Velatir shows which projects exist, who owns them, which are published and to whom, who is in the workspace, and what Lovable’s security checks have found. You connect once, with an API key from the workspace. There is nothing to install and nothing for your builders to do.
Lovable’s API is available on the Business and Enterprise plans. Free and Pro workspaces cannot be connected.

What It Brings In

Projects

Every project in the workspace, with its owner, when it was last edited, and who in the workspace can see it.

Published apps

Which projects are published, and whether the app is open to everyone, to the workspace, or to chosen groups.

Members

Who is in the workspace, their role, and how many projects each person owns and has published.

Security findings

Lovable’s Security Center overview for the workspace, and the findings of each project’s latest security scan.

Visitors

Visitors and page views of each published app over the last 30 days.

Workspace settings

The plan, the default project visibility, the publishing policy, and whether single sign-on is enforced.
The connector does not bring in prompts or answers. Lovable’s API does not offer them. Velatir sees what people type into Lovable through the browser extension, where agents can also coach or block at the moment of use. Velatir only reads. It never publishes, unpublishes, changes, or deletes anything in Lovable.

Before You Start

A Velatir Administrator

Only an organisation Administrator can connect, reconnect, or disconnect. See Roles & permissions.

A Lovable workspace owner or admin

Only an owner or admin of the Lovable workspace can create an API key.

An API key with read access

In Lovable, open Workspace settings, then API keys & OAuth, and create a workspace access token. Set both Workspace and Projects to Read. Copy the key when it is shown. Lovable shows it only once.
With Projects set to None, the connection still works. Velatir then shows projects and members, but no security scan findings and no visitors.

Connect Lovable

Find Lovable in the Inventory

In Velatir, open Inventory from the sidebar. If there is no Lovable card, select Declare service(s) and declare Lovable. The card then shows Declared · not connected.

Start the connection

Select Connect on the Lovable card.

Name it and paste the key

Give the connection a name and paste the API key. Select Connect.

Velatir checks the key

Velatir asks Lovable for the key’s workspace. When that works, the key is saved and the card shows the connection. If Lovable refuses, the dialog says why, and nothing is saved.
The key is stored securely and never shown again, not even in part.
A Lovable key belongs to one workspace. To read another workspace, select Add connection and paste a key from that workspace.

After You Connect

A project deleted in Lovable, or a member removed from the workspace, disappears from Velatir at the next update. Scan findings and visitors are read for the 200 most recently edited projects of the workspace. A project created during the day gets them at the next daily update. The Security Center overview needs a key created by someone with access to Lovable’s Security Center. Without it, everything else still arrives. Connecting also tells Velatir that your organisation has a company plan with Lovable, so the Lovable service in the Inventory shows Paid – Company among its subscriptions.

Managing the Connection

Select Reconnect on the connection and paste a new key from the same workspace. The old key keeps working until the new one is verified.
Select Disconnect on the Lovable card and confirm. Velatir deletes the key and stops reading straight away, and the workspace’s projects and members are no longer shown. Revoke the key in Lovable as well if you do not plan to reconnect.
Revoking the key stops Velatir’s access. Velatir checks its access every 15 minutes, so the connection shows Action needed within that time.
Lovable lets you set an expiry on a key. When it passes, the connection shows Action needed. Create a new key and select Reconnect.
One connection reads one workspace. To add another, select Add connection in the card’s Connections section and paste that workspace’s key.

Troubleshooting

The key is mistyped, was revoked, or has expired. Create a new one in Lovable under Workspace settings, API keys & OAuth, and paste that one.
The workspace is on the Free or Pro plan, which has no API. Upgrade the workspace in Lovable, then connect again.
The key was created with Workspace set to None. Create a new key with Workspace set to Read.
The key only accepts requests from addresses you listed in Lovable. Create a key without an IP allowlist, or contact hello@velatir.com for the addresses to add.
Lovable accepted the key but returned no workspace for it. Create a new key in the workspace you want to connect.
The key was created with Projects set to None, or the first daily update has not run yet. Check the key’s access in Lovable. Visitors are only shown for published apps.

Connectors

How connectors work in general.

Browser extension

See and guide what people type into Lovable.