> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velatir.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lovable

> Connect a Lovable workspace with an API key to see what your organisation builds in Lovable: projects, owners, published apps, members, and Lovable's security findings.

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.

> [!NOTE]
>
> Lovable's API is available on the **Business** and **Enterprise** plans. Free and Pro workspaces cannot be connected.

## What It Brings In

> [card] Projects
>
> Every project in the workspace, with its owner, when it was last edited, and who in the workspace can see it.

> [card] Published apps
>
> Which projects are published, and whether the app is open to everyone, to the workspace, or to chosen groups.

> [card] Members
>
> Who is in the workspace, their role, and how many projects each person owns and has published.

> [card] Security findings
>
> Lovable's Security Center overview for the workspace, and the findings of each project's latest security scan.

> [card] Visitors
>
> Visitors and page views of each published app over the last 30 days.

> [card] 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](https://docs.velatir.com/setup/browser-extension.md), 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

**1. A Velatir Administrator**

Only an organisation **Administrator** can connect, reconnect, or disconnect. See [Roles & permissions](https://docs.velatir.com/platform/roles-and-permissions.md).

**2. A Lovable workspace owner or admin**

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

**3. 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.

> [!TIP]
>
> 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

**1. 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**.

**2. Start the connection**

Select **Connect** on the **Lovable** card.

**3. Name it and paste the key**

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

**4. 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.

> [!WARNING]
>
> A Lovable key belongs to one workspace. To read another workspace, select **Add connection** and paste a key from that workspace.

## After You Connect

| What | When it appears | How often it updates |
| - | - | - |
| **Projects, members, and workspace settings** | Within a few minutes | Every 15 minutes |
| **Security Center overview** | Within a few minutes | Every 15 minutes |
| **Security scan findings per project** | Within a few minutes | Once a day |
| **Visitors per published app** | Within a few minutes | Once a day |

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

> [accordion] Rotate the key
>
> 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.

> [accordion] Disconnect
>
> 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.

> [accordion] Revoke the key in Lovable
>
> Revoking the key stops Velatir's access. Velatir checks its access every 15 minutes, so the connection shows **Action needed** within that time.

> [accordion] A key that expires
>
> Lovable lets you set an expiry on a key. When it passes, the connection shows **Action needed**. Create a new key and select **Reconnect**.

> [accordion] Connect another workspace
>
> One connection reads one workspace. To add another, select **Add connection** in the card's **Connections** section and paste that workspace's key.

## Troubleshooting

> [accordion] Lovable did not accept this API key
>
> 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.

> [accordion] Lovable's API needs a Business or Enterprise workspace
>
> The workspace is on the Free or Pro plan, which has no API. Upgrade the workspace in Lovable, then connect again.

> [accordion] This API key cannot read the workspace
>
> The key was created with **Workspace** set to **None**. Create a new key with **Workspace** set to **Read**.

> [accordion] This API key has an IP allowlist that does not include Velatir
>
> The key only accepts requests from addresses you listed in Lovable. Create a key without an IP allowlist, or contact [hello@velatir.com](mailto:hello@velatir.com) for the addresses to add.

> [accordion] This API key reaches no Lovable workspace
>
> Lovable accepted the key but returned no workspace for it. Create a new key in the workspace you want to connect.

> [accordion] Projects show no security findings or visitors
>
> 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.

***

> [card] [Connectors](https://docs.velatir.com/connectors/overview.md)
>
> How connectors work in general.

> [card] [Browser extension](https://docs.velatir.com/setup/browser-extension.md)
>
> See and guide what people type into Lovable.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.