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.
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
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
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.
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.
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.
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.
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
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.
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.
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.
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 for the addresses to add.
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.
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.
Connectors
How connectors work in general.
Browser extension
See and guide what people type into Lovable.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Velatir Documentation","colors":{"primary":"#F74F4F","light":"#F74F4F","dark":"#F74F4F"},"logo":{"light":"https://mintcdn.com/velatir/6i9H6z-me2OLzEfw/logo/light.svg?fit=max\u0026auto=format\u0026n=6i9H6z-me2OLzEfw\u0026q=85\u0026s=4da095233383ab94faa550f4f9289733","dark":"https://mintcdn.com/velatir/6i9H6z-me2OLzEfw/logo/dark.svg?fit=max\u0026auto=format\u0026n=6i9H6z-me2OLzEfw\u0026q=85\u0026s=2d0618d2d4d97e78696cf17c52992fb5"},"favicon":"https://mintcdn.com/velatir/Cf4hAnbgP5yfxG6r/favicon-16x16.png?fit=max\u0026auto=format\u0026n=Cf4hAnbgP5yfxG6r\u0026q=85\u0026s=a7e9822742ce10a2c8ca8cd3f1349028","appearance":{"default":"light"},"background":{"color":{"light":"#F5F1EA","dark":"#310020"}},"navbar":{"links":[{"href":"mailto:hello@velatir.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.velatir.com"}},"footer":{"socials":{"x":"https://x.com/WeAreVelatir","linkedin":"https://www.linkedin.com/company/velatir"}},"fonts":{"family":"Inter"},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"velatir","hasAudioNarration":false,"actualSubdomain":"velatir","customDomains":["docs.velatir.com"],"gitSource":{"type":"github","owner":"velatir","repo":"velatir-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afbfb19e2d934d45d19d5f2","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Documentation","count":66},{"language":"default","tag":"Velatir for Desktop","count":15},{"language":"default","tag":"Connectors","count":10},{"language":"default","tag":"Agents","count":8},{"language":"default","tag":"Platform","count":6},{"language":"default","tag":"Insights","count":5},{"language":"default","tag":"Browser extension","count":5},{"language":"default","tag":"Developers","count":4},{"language":"default","tag":"Microsoft 365","count":4},{"language":"default","tag":"Sessions \u0026 Traces","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--rounded-xs: 4px;--rounded-sm: 4px;--rounded: 4px;--rounded-md: 4px;--rounded-lg: 4px;--rounded-xl: 4px;--rounded-2xl: 4px;--rounded-3xl: 4px;--rounded-4xl: 4px}#topbar-cta-button a span.bg-primary-dark{background-color:#310020}#topbar-cta-button a span.z-10{color:#F5F1EA}.dark #topbar-cta-button a span.bg-primary-dark{background-color:#D1DFDD}.dark #topbar-cta-button a span.z-10{color:#310020}.dark #topbar-cta-button a svg{color:#310020}.dark .accordion-group{border-color:rgba(245, 241, 234, 0.15);divide-color:rgba(245, 241, 234, 0.15)}.dark details.accordion{background-color:rgba(245, 241, 234, 0.05)!important}.dark details.accordion>summary:hover{background-color:rgba(245, 241, 234, 0.1)!important}"}],"page":{"pagePath":"connectors/lovable","slug":"/connectors/lovable","pageMetadata":{"title":"Lovable","description":"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.","href":"/connectors/lovable"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"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.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,hr:`hr`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CardGroup,Heading,Note,Step,Steps,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`You connect once, with an API key from the workspace. There is nothing to install and nothing for your builders to do.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Lovable’s API is available on the `,_jsx(_components.strong,{children:`Business`}),` and `,_jsx(_components.strong,{children:`Enterprise`}),` plans. Free and Pro workspaces cannot be connected.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`what-it-brings-in`,children:`What It Brings In`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Projects`,icon:`layout-grid`,children:_jsx(_components.p,{children:`Every project in the workspace, with its owner, when it was last edited, and who in the workspace can see it.`})}),_jsx(Card,{title:`Published apps`,icon:`globe`,children:_jsx(_components.p,{children:`Which projects are published, and whether the app is open to everyone, to the workspace, or to chosen groups.`})}),_jsx(Card,{title:`Members`,icon:`users`,children:_jsx(_components.p,{children:`Who is in the workspace, their role, and how many projects each person owns and has published.`})}),_jsx(Card,{title:`Security findings`,icon:`shield-alert`,children:_jsx(_components.p,{children:`Lovable’s Security Center overview for the workspace, and the findings of each project’s latest security scan.`})}),_jsx(Card,{title:`Visitors`,icon:`chart-line`,children:_jsx(_components.p,{children:`Visitors and page views of each published app over the last 30 days.`})}),_jsx(Card,{title:`Workspace settings`,icon:`settings`,children:_jsx(_components.p,{children:`The plan, the default project visibility, the publishing policy, and whether single sign-on is enforced.`})})]}),`\n`,_jsxs(_components.p,{children:[`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 `,_jsx(_components.a,{href:`/setup/browser-extension`,children:`browser extension`}),`, where agents can also coach or block at the moment of use.`]}),`\n`,_jsx(_components.p,{children:`Velatir only reads. It never publishes, unpublishes, changes, or deletes anything in Lovable.`}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before You Start`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`A Velatir Administrator`,icon:`user-cog`,children:_jsxs(_components.p,{children:[`Only an organisation `,_jsx(_components.strong,{children:`Administrator`}),` can connect, reconnect, or disconnect. See `,_jsx(_components.a,{href:`/platform/roles-and-permissions`,children:`Roles \u0026 permissions`}),`.`]})}),_jsx(Step,{title:`A Lovable workspace owner or admin`,icon:`user-check`,children:_jsx(_components.p,{children:`Only an owner or admin of the Lovable workspace can create an API key.`})}),_jsx(Step,{title:`An API key with read access`,icon:`key-round`,children:_jsxs(_components.p,{children:[`In Lovable, open `,_jsx(_components.strong,{children:`Workspace settings`}),`, then `,_jsx(_components.strong,{children:`API keys \u0026 OAuth`}),`, and create a workspace access token. Set both `,_jsx(_components.strong,{children:`Workspace`}),` and `,_jsx(_components.strong,{children:`Projects`}),` to `,_jsx(_components.strong,{children:`Read`}),`. Copy the key when it is shown. Lovable shows it only once.`]})})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`With `,_jsx(_components.strong,{children:`Projects`}),` set to `,_jsx(_components.strong,{children:`None`}),`, the connection still works. Velatir then shows projects and members, but no security scan findings and no visitors.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`connect-lovable`,children:`Connect Lovable`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Find Lovable in the Inventory`,icon:`clipboard-list`,children:_jsxs(_components.p,{children:[`In Velatir, open `,_jsx(_components.strong,{children:`Inventory`}),` from the sidebar. If there is no `,_jsx(_components.strong,{children:`Lovable`}),` card, select `,_jsx(_components.strong,{children:`Declare service(s)`}),` and declare Lovable. The card then shows `,_jsx(_components.strong,{children:`Declared · not connected`}),`.`]})}),_jsx(Step,{title:`Start the connection`,icon:`plug`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Connect`}),` on the `,_jsx(_components.strong,{children:`Lovable`}),` card.`]})}),_jsx(Step,{title:`Name it and paste the key`,icon:`key-round`,children:_jsxs(_components.p,{children:[`Give the connection a name and paste the API key. Select `,_jsx(_components.strong,{children:`Connect`}),`.`]})}),_jsx(Step,{title:`Velatir checks the key`,icon:`circle-check`,children:_jsx(_components.p,{children:`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.`})})]}),`\n`,_jsx(_components.p,{children:`The key is stored securely and never shown again, not even in part.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`A Lovable key belongs to one workspace. To read another workspace, select `,_jsx(_components.strong,{children:`Add connection`}),` and paste a key from that workspace.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`after-you-connect`,children:`After You Connect`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`What`}),_jsx(_components.th,{children:`When it appears`}),_jsx(_components.th,{children:`How often it updates`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Projects, members, and workspace settings`})}),_jsx(_components.td,{children:`Within a few minutes`}),_jsx(_components.td,{children:`Every 15 minutes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Security Center overview`})}),_jsx(_components.td,{children:`Within a few minutes`}),_jsx(_components.td,{children:`Every 15 minutes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Security scan findings per project`})}),_jsx(_components.td,{children:`Within a few minutes`}),_jsx(_components.td,{children:`Once a day`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Visitors per published app`})}),_jsx(_components.td,{children:`Within a few minutes`}),_jsx(_components.td,{children:`Once a day`})]})]})]}),`\n`,_jsx(_components.p,{children:`A project deleted in Lovable, or a member removed from the workspace, disappears from Velatir at the next update.`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`The Security Center overview needs a key created by someone with access to Lovable’s Security Center. Without it, everything else still arrives.`}),`\n`,_jsxs(_components.p,{children:[`Connecting also tells Velatir that your organisation has a company plan with Lovable, so the Lovable service in the Inventory shows `,_jsx(_components.strong,{children:`Paid – Company`}),` among its subscriptions.`]}),`\n`,_jsx(Heading,{level:`2`,id:`managing-the-connection`,children:`Managing the Connection`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Rotate the key`,icon:`refresh-cw`,id:`rotate-the-key`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Reconnect`}),` on the connection and paste a new key from the same workspace. The old key keeps working until the new one is verified.`]})}),_jsx(Accordion,{title:`Disconnect`,icon:`unplug`,id:`disconnect`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Disconnect`}),` on the `,_jsx(_components.strong,{children:`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.`]})}),_jsx(Accordion,{title:`Revoke the key in Lovable`,icon:`shield-off`,id:`revoke-the-key-in-lovable`,children:_jsxs(_components.p,{children:[`Revoking the key stops Velatir’s access. Velatir checks its access every 15 minutes, so the connection shows `,_jsx(_components.strong,{children:`Action needed`}),` within that time.`]})}),_jsx(Accordion,{title:`A key that expires`,icon:`calendar-clock`,id:`a-key-that-expires`,children:_jsxs(_components.p,{children:[`Lovable lets you set an expiry on a key. When it passes, the connection shows `,_jsx(_components.strong,{children:`Action needed`}),`. Create a new key and select `,_jsx(_components.strong,{children:`Reconnect`}),`.`]})}),_jsx(Accordion,{title:`Connect another workspace`,icon:`plus`,id:`connect-another-workspace`,children:_jsxs(_components.p,{children:[`One connection reads one workspace. To add another, select `,_jsx(_components.strong,{children:`Add connection`}),` in the card’s `,_jsx(_components.strong,{children:`Connections`}),` section and paste that workspace’s key.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Lovable did not accept this API key`,id:`lovable-did-not-accept-this-api-key`,children:_jsxs(_components.p,{children:[`The key is mistyped, was revoked, or has expired. Create a new one in Lovable under `,_jsx(_components.strong,{children:`Workspace settings`}),`, `,_jsx(_components.strong,{children:`API keys \u0026 OAuth`}),`, and paste that one.`]})}),_jsx(Accordion,{title:`Lovable's API needs a Business or Enterprise workspace`,id:`lovables-api-needs-a-business-or-enterprise-workspace`,children:_jsx(_components.p,{children:`The workspace is on the Free or Pro plan, which has no API. Upgrade the workspace in Lovable, then connect again.`})}),_jsx(Accordion,{title:`This API key cannot read the workspace`,id:`this-api-key-cannot-read-the-workspace`,children:_jsxs(_components.p,{children:[`The key was created with `,_jsx(_components.strong,{children:`Workspace`}),` set to `,_jsx(_components.strong,{children:`None`}),`. Create a new key with `,_jsx(_components.strong,{children:`Workspace`}),` set to `,_jsx(_components.strong,{children:`Read`}),`.`]})}),_jsx(Accordion,{title:`This API key has an IP allowlist that does not include Velatir`,id:`this-api-key-has-an-ip-allowlist-that-does-not-include-velatir`,children:_jsxs(_components.p,{children:[`The key only accepts requests from addresses you listed in Lovable. Create a key without an IP allowlist, or contact `,_jsx(_components.a,{href:`mailto:hello@velatir.com`,children:`hello@velatir.com`}),` for the addresses to add.`]})}),_jsx(Accordion,{title:`This API key reaches no Lovable workspace`,id:`this-api-key-reaches-no-lovable-workspace`,children:_jsx(_components.p,{children:`Lovable accepted the key but returned no workspace for it. Create a new key in the workspace you want to connect.`})}),_jsx(Accordion,{title:`Projects show no security findings or visitors`,id:`projects-show-no-security-findings-or-visitors`,children:_jsxs(_components.p,{children:[`The key was created with `,_jsx(_components.strong,{children:`Projects`}),` set to `,_jsx(_components.strong,{children:`None`}),`, or the first daily update has not run yet. Check the key’s access in Lovable. Visitors are only shown for published apps.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Connectors`,icon:`plug`,href:`/connectors/overview`,children:_jsx(_components.p,{children:`How connectors work in general.`})}),_jsx(Card,{title:`Browser extension`,icon:`puzzle`,href:`/setup/browser-extension`,children:_jsx(_components.p,{children:`See and guide what people type into Lovable.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Lovable","description":"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.","href":"/connectors/lovable"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What It Brings In","slug":"what-it-brings-in","depth":2,"children":[]},{"title":"Before You Start","slug":"before-you-start","depth":2,"children":[]},{"title":"Connect Lovable","slug":"connect-lovable","depth":2,"children":[]},{"title":"After You Connect","slug":"after-you-connect","depth":2,"children":[]},{"title":"Managing the Connection","slug":"managing-the-connection","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"velatir","siteName":"Velatir Documentation","title":"Lovable - Velatir Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T06:58:36.035Z","originalFileLocation":"connectors/lovable.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect a Lovable workspace with an API key to see what your organisation builds in Lovable: projects, owners, published apps, members, and Lovable\u0026#x27;s security findings.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Velatir Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/velatir/hMpZUI8d6w-s4nbW/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/velatir/hMpZUI8d6w-s4nbW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/velatir/hMpZUI8d6w-s4nbW/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/velatir/hMpZUI8d6w-s4nbW/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/velatir/hMpZUI8d6w-s4nbW/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/velatir/hMpZUI8d6w-s4nbW/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/velatir/hMpZUI8d6w-s4nbW/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/velatir/hMpZUI8d6w-s4nbW/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/velatir/hMpZUI8d6w-s4nbW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Lovable - Velatir Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect a Lovable workspace with an API key to see what your organisation builds in Lovable: projects, owners, published apps, members, and Lovable\u0026#x27;s security findings.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Velatir Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.velatir.com/connectors/lovable\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://velatir.mintlify.site/_mintlify/api/og/v2?division=Connectors\u0026amp;title=Lovable\u0026amp;description=Connect+a+Lovable+workspace+with+an+API+key+to+see+what+your+organisation+builds+in+Lovable%3A+projects%2C+owners%2C+published+apps%2C+members%2C+and+Lovable%27s+security+f\u0026amp;theme=69a58d7d087387b3f7c9be5d\u0026amp;signature=c7a7d2215621d421a06fd322ae7839669e7d81a08cba3ba0979571b856a80a6a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Lovable - Velatir Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect a Lovable workspace with an API key to see what your organisation builds in Lovable: projects, owners, published apps, members, and Lovable\u0026#x27;s security findings.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://velatir.mintlify.site/_mintlify/api/og/v2?division=Connectors\u0026amp;title=Lovable\u0026amp;description=Connect+a+Lovable+workspace+with+an+API+key+to+see+what+your+organisation+builds+in+Lovable%3A+projects%2C+owners%2C+published+apps%2C+members%2C+and+Lovable%27s+security+f\u0026amp;theme=69a58d7d087387b3f7c9be5d\u0026amp;signature=c7a7d2215621d421a06fd322ae7839669e7d81a08cba3ba0979571b856a80a6a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/velatir/hMpZUI8d6w-s4nbW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Velatir Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F74F4F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.velatir.com/connectors/lovable\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/connectors/lovable.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.velatir.com/#organization\",\"name\":\"Velatir Documentation\",\"url\":\"https://docs.velatir.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/velatir/6i9H6z-me2OLzEfw/logo/light.svg?fit=max\u0026auto=format\u0026n=6i9H6z-me2OLzEfw\u0026q=85\u0026s=4da095233383ab94faa550f4f9289733\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.velatir.com#website\",\"name\":\"Velatir Documentation\",\"url\":\"https://docs.velatir.com\",\"publisher\":{\"@id\":\"https://docs.velatir.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.velatir.com/connectors/lovable#webpage\",\"url\":\"https://docs.velatir.com/connectors/lovable\",\"name\":\"Lovable\",\"description\":\"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.\",\"dateModified\":\"2026-11-17T06:58:36.035Z\",\"isPartOf\":{\"@id\":\"https://docs.velatir.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.velatir.com/connectors/lovable#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.velatir.com/connectors/lovable#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connectors\",\"item\":\"https://docs.velatir.com/connectors/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Lovable\",\"item\":\"https://docs.velatir.com/connectors/lovable\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.velatir.com/connectors/lovable#article\",\"headline\":\"Lovable\",\"name\":\"Lovable\",\"description\":\"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.\",\"url\":\"https://docs.velatir.com/connectors/lovable\",\"mainEntityOfPage\":{\"@id\":\"https://docs.velatir.com/connectors/lovable#webpage\"},\"dateModified\":\"2026-11-17T06:58:36.035Z\",\"publisher\":{\"@id\":\"https://docs.velatir.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.velatir.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Velatir Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Velatir Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/connectors/lovable.md","siteName":"Velatir Documentation","nav":{"global":null,"dropdowns":[{"dropdown":"Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Introduction to Velatir","href":"/introduction"},{"title":"Quickstart","href":"/quickstart"},{"title":"Core Concepts","href":"/core-concepts"}]},{"group":"Platform","pages":[{"title":"Getting Around the Dashboard","sidebarTitle":"Getting around","href":"/platform/getting-around"},{"title":"Organisations \u0026 Workspaces","href":"/platform/organizations-and-workspaces"},{"title":"Settings","href":"/platform/settings"},{"title":"Branding \u0026 Messaging","href":"/platform/branding-and-messaging"},{"title":"Microsoft Entra","href":"/platform/microsoft-entra"},{"title":"Roles \u0026 Permissions","href":"/platform/roles-and-permissions"}]},{"group":"Velatir for Desktop","pages":[{"title":"Overview","href":"/desktop-app/overview"},{"title":"Download and Install","href":"/desktop-app/download-and-install"},{"title":"Uninstall Cleanup","href":"/desktop-app/uninstall-cleanup"},{"title":"How It Works","href":"/desktop-app/how-it-works"},{"title":"AI Tool Coverage","href":"/desktop-app/ai-tool-coverage"},{"title":"MCP Server Discovery","href":"/desktop-app/mcp-servers"},{"title":"Updates and Rollout Safety","href":"/desktop-app/rollout-safety"},{"title":"Permissions","href":"/desktop-app/permissions"},{"title":"System requirements","href":"/desktop-app/system-requirements"},{"title":"Enterprise Deployment","href":"/desktop-app/enterprise-deployment"},{"title":"Directory Context","href":"/desktop-app/directory-context"},{"title":"CLI Reference","href":"/desktop-app/cli"},{"title":"Health Checks","href":"/desktop-app/health-checks"},{"title":"Troubleshooting","href":"/desktop-app/troubleshooting"},{"title":"FAQ","href":"/desktop-app/faq"}]},{"group":"Browser extension","pages":[{"title":"Browser Extension","href":"/setup/browser-extension"},{"title":"Browser Extension - Managed Deployment","href":"/setup/browser-extension-managed"},{"title":"Browser Extension - Windows (Group Policy / Registry)","href":"/setup/browser-extension-windows-advanced"},{"title":"Browser Extension - macOS (Jamf / MDM)","href":"/setup/browser-extension-macos"},{"title":"Browser Extension - Safari (macOS)","href":"/setup/browser-extension-safari"}]},{"group":"Connectors","pages":[{"title":"Connectors","sidebarTitle":"Overview","href":"/connectors/overview"},{"group":"Microsoft 365","pages":[{"title":"Microsoft 365","sidebarTitle":"Overview","href":"/connectors/microsoft-365"},{"title":"Permissions","href":"/connectors/microsoft-365/permissions"},{"title":"What Velatir Collects","href":"/connectors/microsoft-365/data"},{"title":"Troubleshooting","href":"/connectors/microsoft-365/troubleshooting"}]},{"title":"Claude Enterprise","href":"/connectors/claude-enterprise"},{"title":"ChatGPT Enterprise","href":"/connectors/openai"},{"title":"Cursor","description":"Connect a Cursor Enterprise team with an Admin API key.","href":"/connectors/cursor"},{"title":"Lovable","href":"/connectors/lovable"},{"title":"Claude Cowork","description":"Send Claude Cowork activity to Velatir by pointing Cowork's OpenTelemetry export at your organisation's Velatir endpoint","href":"/connectors/claude-cowork"}]},{"group":"Agents","pages":[{"title":"Understanding Agents","href":"/agents/understanding-agents"},{"title":"Gatekeeper","href":"/agents/gatekeeper"},{"title":"Data Protector","href":"/agents/data-protector"},{"title":"Coach","href":"/agents/coach"},{"title":"Redaction","href":"/agents/redaction"},{"title":"Instructions","href":"/agents/instructions"},{"title":"Assessments","href":"/agents/assessments"},{"title":"Configuring Agents","href":"/agents/configuring-agents"}]},{"group":"Sessions \u0026 Traces","pages":[{"title":"Understanding Sessions","href":"/traces/understanding-sessions"},{"title":"Traces","href":"/traces/traces"},{"title":"Trace Lifecycle","href":"/traces/trace-lifecycle"},{"title":"Escalations","href":"/traces/escalations"}]},{"group":"Insights","pages":[{"title":"Insights Overview","href":"/insights/overview"},{"title":"Use Cases","href":"/insights/use-cases"},{"title":"AI Literacy","href":"/insights/ai-literacy"},{"title":"MCP Servers","href":"/insights/mcp-servers"},{"title":"Service Catalogue","href":"/insights/service-catalog"}]},{"group":"Reports","pages":[{"title":"Reports","href":"/reports/overview"}]},{"group":"Inventory","pages":[{"title":"Inventory","sidebarTitle":"Overview","href":"/inventory/overview"},{"title":"Service Risk","href":"/inventory/service-risk"}]},{"group":"Developers","pages":[{"title":"Velatir API","href":"/api/overview"},{"title":"Authentication","href":"/api/authentication"},{"title":"Instructions Over the API","href":"/api/instructions"},{"title":"Developer integrations","href":"/integrations/overview"}]},{"group":"For Providers","pages":[{"title":"AI usage data specification","href":"/providers/ai-data-specification"}]},{"group":"Security \u0026 Privacy","pages":[{"title":"Data Privacy","href":"/security/data-privacy"},{"title":"Data Storage \u0026 Encryption","href":"/security/data-storage-and-encryption"}]}]}]},"basePath":"","title":"Lovable - Velatir Documentation","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}