Lovable
App · 24 actions
Manage workspaces, projects, publishing, security scans and analytics in Lovable.
Actions
| Action | What it does |
|---|---|
| Create embed URL | Create a preview link for a project that can be shown in a frame on one website you name, without a Lovable login, until it expires. |
| Delete project | Delete a project. |
| Get project | Get one project. |
| Get project analytics | Get visitor analytics for a project over a time range. |
| Get project analytics breakdowns | Get a project's top visitor countries, devices, pages and other breakdowns over a time range. |
| Get project realtime analytics | Get a project's visitors over the last 30 minutes, minute by minute. |
| Get publish status | Get the status of a publish, and the reason if it failed. |
| Get security scan | Get one security scan of a project. |
| Get workspace | Get one workspace. |
| Get workspace analytics | Get visitor analytics for a whole workspace over a time range. |
| Get workspace member | Get one member of a workspace. |
| Get workspace security insights | Get a workspace's security overview: the types of finding, how many projects have each, and how urgently they need review. |
| List personal data findings | List the personal data found in a project. |
| List projects | List projects; you can filter by workspace, visibility, whether they are published and who can open them. |
| List security scan findings | List the findings of one security scan. |
| List security scans | List a project's security scans. |
| List workspace groups | List the groups in a workspace. |
| List workspace members | List a workspace's members; you can search, filter by role and sort. |
| List workspace security project inventory | List a workspace's projects with their security details, such as whether they are published, hold personal data or use connectors; you can search, filter and sort. |
| List workspaces | List the workspaces you can access. |
| Publish project | Publish a project, optionally choosing who can open it. |
| Unpublish project | Take a project's published app offline. |
| Update project | Change a project's name or visibility. |
| Update publish settings | Change who can open a project's published app. |
Create embed URL
Create a preview link for a project that can be shown in a frame on one website you name, without a Lovable login, until it expires. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
- Parent origin
parent_origintextRequired - HTTPS origin allowed to embed the preview, using a lowercase hostname with no port, trailing slash, path, query, or fragment. The preview URL only loads in an iframe on this origin.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"embed_url": "example",
"expires_at": "example"
}
}Delete project
Delete a project. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {}
}Get project
Get one project. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"created_at": "example",
"description": "example",
"id": "example",
"is_published": false,
"last_edited_at": "example",
"latest_commit_sha": "example",
"latest_screenshot_url": "example",
"name": "example",
"owner_id": "example",
"preview_url": "example",
"publish_audience": "public",
"publish_audience_targets": [],
"visibility": "restricted",
"workspace_id": "example"
}
}Get project analytics
Get visitor analytics for a project over a time range. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
- Starts at
starts_atdate and timeRequired - Start of the time range as an RFC 3339 timestamp, such as 2026-04-01T00:00:00Z. Any offset is accepted and converted to UTC before the range is applied.
- Ends at
ends_atdate and timeRequired - End of the time range as an RFC 3339 timestamp, such as 2026-04-08T00:00:00Z. Any offset is accepted and converted to UTC before the range is applied.
- Granularity
granularitytext - Time-bucket size: hourly or daily. Defaults to daily when omitted; any other value returns 400. Daily buckets cover complete UTC calendar dates from the UTC date of starts_at through the UTC date of ends_at; hourly buckets use the supplied instants inclusively and support at most 31 days.One of:
hourly,daily. Default:daily.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"time_series": {
"bounce_rate": {
"data": [],
"label": "example",
"total": 1.0
},
"pageviews": {
"data": [],
"label": "example",
"total": 1.0
},
"pageviews_per_visit": {
"data": [],
"label": "example",
"total": 1.0
},
"session_duration": {
"data": [],
"label": "example",
"total": 1.0
},
"visitors": {
"data": [],
"label": "example",
"total": 1.0
}
}
}
}Get project analytics breakdowns
Get a project's top visitor countries, devices, pages and other breakdowns over a time range. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
- Starts at
starts_atdate and timeRequired - Start of the time range as an RFC 3339 timestamp, such as 2026-04-01T00:00:00Z. Any offset is accepted and converted to UTC; the range covers complete UTC calendar dates from the UTC date of starts_at through the UTC date of ends_at.
- Ends at
ends_atdate and timeRequired - End of the time range as an RFC 3339 timestamp, such as 2026-04-08T00:00:00Z. Any offset is accepted and converted to UTC; the range covers complete UTC calendar dates from the UTC date of starts_at through the UTC date of ends_at.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"countries": [],
"devices": [],
"pages": [],
"sources": []
}
}Get project realtime analytics
Get a project's visitors over the last 30 minutes, minute by minute. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"buckets": [],
"current_visitors": 1
}
}Get publish status
Get the status of a publish, and the reason if it failed. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
- Deployment id
deployment_idtextRequired - Deployment ID returned by POST /v1/projects/{project_id}/publish.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"error_class": "transient",
"error_message": "example",
"id": "example",
"status": "running",
"url": "example"
}
}Get security scan
Get one security scan of a project. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
- Scan id
scan_idtextRequired - Security scan ID returned by the list endpoint.
Outputs
dataobject- Status and timing of the security scan. Retrieve findings from this scan's paginated findings endpoint.
Example output
{
"data": {
"commit_sha": "example",
"finished_at": "example",
"id": "example",
"requested_scanners": [],
"started_at": "example",
"status": "running"
}
}Get workspace
Get one workspace. Needs a Lovable Business plan or higher.
Inputs
- Workspace
workspace_idtextRequired - Workspace ID.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"billing_period_ends_at": "example",
"billing_period_starts_at": "example",
"created_at": "example",
"default_monthly_member_credit_limit": 1.0,
"default_project_visibility": "restricted",
"description": "example",
"enable_pii": false,
"enforce_sso": false,
"id": "example",
"image_url": "example",
"name": "example",
"num_projects": 1,
"num_seats": 1,
"plan": "free",
"publishing_policy": "org_only",
"updated_at": "example"
}
}Get workspace analytics
Get visitor analytics for a whole workspace over a time range. Needs a Lovable Business plan or higher.
Inputs
- Workspace
workspace_idtextRequired - Workspace ID.
- Starts at
starts_atdate and timeRequired - Start of the time range as an RFC 3339 timestamp, such as 2026-07-01T00:00:00Z. Any offset is accepted and converted to UTC before the range is applied.
- Ends at
ends_atdate and timeRequired - End of the time range as an RFC 3339 timestamp, such as 2026-07-08T00:00:00Z. Any offset is accepted and converted to UTC before the range is applied.
- Granularity
granularitytext - Time-bucket size: hourly or daily. Defaults to daily when omitted; any other value returns 400. Daily buckets cover complete UTC calendar dates from the UTC date of starts_at through the UTC date of ends_at; hourly buckets use the supplied instants inclusively and support at most 31 days.One of:
hourly,daily. Default:daily.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"time_series": {
"bounce_rate": {
"data": [],
"label": "example",
"total": 1.0
},
"pageviews": {
"data": [],
"label": "example",
"total": 1.0
},
"pageviews_per_visit": {
"data": [],
"label": "example",
"total": 1.0
},
"session_duration": {
"data": [],
"label": "example",
"total": 1.0
},
"visitors": {
"data": [],
"label": "example",
"total": 1.0
}
}
}
}Get workspace member
Get one member of a workspace. Needs a Lovable Business plan or higher.
Inputs
- Workspace
workspace_idtextRequired - Workspace ID.
- User id
resource_user_idtextRequired - User ID returned by the workspace members endpoint.
Outputs
dataobject- The active workspace member.
Example output
{
"data": {
"email": "example",
"name": "example",
"type": "user",
"user_id": "example",
"workspace_id": "example"
}
}Get workspace security insights
Get a workspace's security overview: the types of finding, how many projects have each, and how urgently they need review. Needs a Lovable Business plan or higher.
Inputs
- Workspace
workspace_idtextRequired - ID of the workspace to retrieve security insights for.
- Review priority
review_prioritylist - Filter finding types by review priority. Repeat to include any of the specified priorities; omit to include all. Only findings are filtered; summary counts remain workspace-wide.One or more of:
needs_review(Needs review),review_recommended(Review recommended),no_review_needed(No review needed).
Outputs
dataobject- Workspace security insights with project and membership counts, review priorities, and finding types.
Example output
{
"data": {
"as_of": "example",
"findings": [],
"summary": {
"externally_published": {
"delta_30d": 1,
"delta_window": "example",
"value": 1
},
"risk": {
"needs_review": 1,
"no_review_needed": 1,
"review_recommended": 1
},
"total_projects": {
"delta_30d": 1,
"delta_window": "example",
"value": 1
},
"workspace_members": {
"delta_30d": 1,
"delta_window": "example",
"value": 1
}
}
}
}List personal data findings
List the personal data found in a project. Needs a Lovable Enterprise plan.
Inputs
- Project
project_idtextRequired - Project ID.
- Limit
limitnumber - Maximum number of items to return per page.From 1 to 100. Default:
50. - Cursor
cursortext - Pass pagination.next_cursor from the previous response to fetch the next page. Omit for the first page; keep the same filters and sort order across pages.
Outputs
dataobject- Personal data findings ordered by found_at, newest first, with label ID breaking ties. Includes open, ignored, and fixed findings.
Example output
{
"data": {
"data": [],
"pagination": {
"has_more": false,
"next_cursor": "example"
}
}
}List projects
List projects; you can filter by workspace, visibility, whether they are published and who can open them. Needs a Lovable Business plan or higher.
Inputs
- Workspace
workspace_idlistRequired - Workspace IDs to list projects from. Repeat the parameter to select up to 10 workspaces; duplicates are ignored. Every workspace must be accessible to the caller. Workspace-scoped API keys can select only their own workspace.
- Visibility
visibilitylist - Filter by the visibility field. Repeat to match any of the values. Omit to include every level you can access.One or more of:
restricted,workspace_edit(Workspace edit),workspace_view(Workspace view). - Is published
is_publishedtrue/false - Filter by whether the project is published. Omit for no filter.
- Publish audience
publish_audiencelist - Filter published projects by the publish_audience field, resolved the same way the response resolves it, including the workspace default. Repeat to match any value. Omit for no filter. Requires is_published to be true or omitted.One or more of:
public,workspace,custom. - Query
querytext - Search project names, generated descriptions, and owner names or email addresses. Terms shorter than 3 characters are ignored.
- Limit
limitnumber - Maximum number of items to return per page.From 1 to 100. Default:
50. - Cursor
cursortext - Pass pagination.next_cursor from the previous response to fetch the next page. Omit for the first page; keep the same filters and sort order across pages.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"data": [],
"pagination": {
"has_more": false,
"next_cursor": "example"
}
}
}List security scan findings
List the findings of one security scan. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
- Scan id
scan_idtextRequired - Security scan ID returned by the list endpoint.
- Limit
limitnumber - Maximum number of items to return per page.From 1 to 100. Default:
50. - Cursor
cursortext - Pass pagination.next_cursor from the previous response to fetch the next page. Omit for the first page; keep the same filters and sort order across pages.
Outputs
dataobject- Findings in this scan snapshot, including results reused from earlier scans and findings marked fixed or ignored. Follow pagination.next_cursor until pagination.has_more is false to retrieve every finding.
Example output
{
"data": {
"data": [],
"pagination": {
"has_more": false,
"next_cursor": "example"
}
}
}List security scans
List a project's security scans. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
- Limit
limitnumber - Maximum number of items to return per page.From 1 to 100. Default:
50. - Cursor
cursortext - Pass pagination.next_cursor from the previous response to fetch the next page. Omit for the first page; keep the same filters and sort order across pages.
Outputs
dataobject- Security scans ordered by started_at, newest first, with id breaking ties. Use GET /v1/projects/{project_id}/security-scans/{scan_id}/findings to retrieve findings.
Example output
{
"data": {
"data": [],
"pagination": {
"has_more": false,
"next_cursor": "example"
}
}
}List workspace groups
List the groups in a workspace. Needs a Lovable Business plan or higher.
Inputs
- Workspace
workspace_idtextRequired - Workspace ID.
- Limit
limitnumber - Maximum number of items to return per page.From 1 to 100. Default:
50. - Cursor
cursortext - Pass pagination.next_cursor from the previous response to fetch the next page. Omit for the first page; keep the same filters and sort order across pages.
Outputs
dataobject- Paginated workspace groups, sorted by name.
Example output
{
"data": {
"data": [],
"pagination": {
"has_more": false,
"next_cursor": "example"
}
}
}List workspace members
List a workspace's members; you can search, filter by role and sort. Needs a Lovable Business plan or higher.
Inputs
- Workspace
workspace_idtextRequired - Workspace ID.
- Limit
limitnumber - Maximum number of items to return per page.From 1 to 100. Default:
50. - Cursor
cursortext - Pass pagination.next_cursor from the previous response to fetch the next page. Omit for the first page; keep the same filters and sort order across pages.
- Query
querytext - Search by display name, username, or email. Terms shorter than 3 characters are ignored.
- Role
rolelist - Filter by the role returned in the response. The legacy values owner, admin, editor, member, viewer, and collaborator remain accepted aliases; member and editor both select workspace_editor. Repeat to match any of the values. Omit to include every role.One or more of:
workspace_owner(Workspace owner),workspace_admin(Workspace admin),workspace_editor(Workspace editor),workspace_viewer(Workspace viewer),external_collaborator(External collaborator),owner,admin,editor,member,viewer,collaborator. - Sort by
sort_bytext - Sort field. Omit for the default order: role precedence (workspace_owner, workspace_admin, workspace_editor, external_collaborator, workspace_viewer), then most recently joined; with query set, best matches first. name sorts case-insensitively by the returned name, with null names first ascending and last descending. display_name is an alias for name, with identical ordering and interchangeable cursors. joined_at falls back to the invitation time. role sorts by role precedence. relevance ranks by match score and requires query; ties break by most recent join. Other ties break by membership id.One of:
name,display_name(Display name),joined_at(Joined at),role,relevance. - Sort order
sort_ordertext - Direction for sort_by. Defaults to descending. Requires sort_by.One of:
asc,desc. - Scim managed
scim_managedtrue/false - Filter by SCIM (System for Cross-domain Identity Management) provisioning: true returns only members provisioned by the identity provider, false only members added another way. Omit to include both.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"data": [],
"pagination": {
"has_more": false,
"next_cursor": "example"
}
}
}List workspace security project inventory
List a workspace's projects with their security details, such as whether they are published, hold personal data or use connectors; you can search, filter and sort. Needs a Lovable Enterprise plan.
Inputs
- Workspace
workspace_idtextRequired - Workspace ID.
- Limit
limitnumber - Maximum number of items to return per page.From 1 to 100. Default:
50. - Cursor
cursortext - Pass pagination.next_cursor from the previous response to fetch the next page. Omit for the first page; keep the same filters and sort order across pages.
- Query
querytext - Free-text search across project name and owner. Terms shorter than 3 characters are ignored. A full project ID matches that project exactly.
- Sort by
sort_bytext - Sort field. Omit for the default order: most recently edited first, or best matches first when query is set. Ties break by project id unless noted. review_priority: unscored projects last in both directions, ties by risk score. name: projects without a name first ascending and last descending. publish_audience: ranks not published, then workspace, custom, public. last_edited_at: falls back to the last update time. risk_factor_count, open_pii_finding_count, external_access_rank: missing counts as 0, ties by name; external_access_rank ranks external collaborators above shared users, publicly published apps, then none; open_pii_finding_count returns 402 when personal data detection is not available on the workspace plan. edits_* and visitors_*: missing counts as 0. last_security_scan_at: never scanned last in both directions. relevance: requires query, ties by last update time.One of:
relevance,review_priority(Review priority),name,publish_audience(Publish audience),last_edited_at(Last edited at),risk_factor_count(Risk factor count),open_pii_finding_count(Open pii finding count),external_access_rank(External access rank),edits_24h(Edits 24h),edits_7d(Edits 7d), and 5 more. - Sort order
sort_ordertext - Direction for sort_by. Defaults to descending. Requires sort_by.One of:
asc,desc. - Activity group
activity_grouplist - Filter by the activity_group field: time since the last edit, or last update for projects never edited, using 14-day and 60-day boundaries. Repeat to match any value. Omit for no filter.One or more of:
last_14_days(Last 14 days),last_60_days(Last 60 days),older. - Is published
is_publishedtrue/false - Filter by whether the project is published. Omit for no filter.
- Visibility
visibilitylist - Filter by the visibility field. Repeat to match any of the values. Omit for no filter.One or more of:
restricted,workspace_edit(Workspace edit),workspace_view(Workspace view). - Has pii
has_piitrue/false - Filter by the has_pii signal. false selects projects without detected personal data. Omit for no filter. Returns 402 when personal data detection is not available on the workspace plan.
- Has connectors
has_connectorstrue/false - Filter by whether the project has a connected service. false selects projects without one. Omit for no filter.
- Publish audience
publish_audiencelist - Filter published projects by the publish_audience field. Repeat to match any value. Omit for no filter. Requires is_published to be true or omitted.One or more of:
public,workspace,custom. - Review priority
review_prioritylist - Filter by Security Center review priority. Repeat to match any selected priority; unscored matches projects not yet scored. Omit to include every project.One or more of:
needs_review(Needs review),review_recommended(Review recommended),no_review_needed(No review needed),unscored. - Finding type id
finding_type_idlist - Finding type IDs returned by GET /v1/workspaces/{workspace_id}/security-center/insights. Finding filters use the same category rules as project_count in that response. A project matching a more specific related type is excluded from the broader type. Repeat to match any selected type. Unknown IDs return 400. Types that depend on personal data detection return 402 when that feature is not available on the workspace plan.
Outputs
dataobject- Projects with security finding counts, review priorities, activity counts, and publishing details.
Example output
{
"data": {
"activity_as_of": {},
"applied_finding": {},
"as_of": "example",
"data": [],
"pagination": {
"has_more": false,
"next_cursor": "example"
},
"total": 1
}
}List workspaces
List the workspaces you can access. Needs a Lovable Business plan or higher.
Inputs
- Limit
limitnumber - Maximum number of items to return per page.From 1 to 100. Default:
50. - Cursor
cursortext - Pass pagination.next_cursor from the previous response to fetch the next page. Omit for the first page; keep the same filters and sort order across pages.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"data": [],
"pagination": {
"has_more": false,
"next_cursor": "example"
}
}
}Publish project
Publish a project, optionally choosing who can open it. Returns the deployment, whose status you can check with Get publish status. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
- Audience
audiencetext - Who can open the published app; project reads report this value as publish_audience. A custom audience can include existing grants managed in the UI. Omit to keep the current setting.One of:
public,workspace,custom. - Audience targets
audience_targetslist - Groups who can open the app; allowed only with audience custom. Providing a list replaces all group and user grants and removes workspace-wide access; an empty list removes those grants. Existing organization access and email invitations managed in the UI are preserved. Omit to preserve saved targets across audience changes. Targets are inactive outside custom mode. Null is not accepted.
- Name
nametext - Slug for the managed published URL: acme-landing-page gives https://acme-landing-page.lovable.app. Custom domains and workspace branding can change the hostname.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"error_class": "transient",
"error_message": "example",
"id": "example",
"status": "running",
"url": "example"
}
}Unpublish project
Take a project's published app offline. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {}
}Update project
Change a project's name or visibility. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
- Name
nametext - Project display name, 1-100 Unicode code points. Must contain a non-whitespace character. Allows Unicode letters, combining marks, numbers, space separators (Zs), punctuation - _ . ' · & ( ) [ ] | , ! : ‘ ’, and the zero-width non-joiner/joiner U+200C/U+200D. Other characters (including 🚀, tabs, and line breaks), links, recognized domain names, and IP addresses are rejected. Leading and trailing spaces are preserved. Omit to keep the current name.
- Visibility
visibilitytext - Who can open the project in the Lovable editor. restricted: only the project owner, invited collaborators, and the workspace owner (Business or Enterprise). workspace_edit: every workspace member, at the access level their workspace role grants. workspace_view: every workspace member, with the access their workspace role grants capped at read; explicit project, folder, and group grants still permit editing (Business or Enterprise). Published app access is configured separately via publish_audience. Omit to keep the current setting.One of:
restricted,workspace_edit(Workspace edit),workspace_view(Workspace view).
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"created_at": "example",
"description": "example",
"id": "example",
"is_published": false,
"last_edited_at": "example",
"latest_commit_sha": "example",
"latest_screenshot_url": "example",
"name": "example",
"owner_id": "example",
"preview_url": "example",
"publish_audience": "public",
"publish_audience_targets": [],
"visibility": "restricted",
"workspace_id": "example"
}
}Update publish settings
Change who can open a project's published app. Needs a Lovable Business plan or higher.
Inputs
- Project
project_idtextRequired - Project ID.
- Audience
audiencetext - Who can open the published app; project reads report this value as publish_audience. A custom audience can include existing grants managed in the UI. Omit to leave the audience unchanged, including while the app is unpublished.One of:
public,workspace,custom. - Audience targets
audience_targetslist - Groups who can open the app; allowed only when the supplied or current audience is custom. Providing a list replaces all group and user grants and removes workspace-wide access; an empty list removes those grants. Existing organization access and email invitations managed in the UI are preserved. Omit to preserve saved targets across audience changes. Targets are inactive outside custom mode. Null is not accepted.
Outputs
dataobject- Lovable response data.
Example output
{
"data": {
"audience": "public",
"audience_targets": []
}
}