Lovable

App · 24 actions

Manage workspaces, projects, publishing, security scans and analytics in Lovable.

Actions

ActionWhat it does
Create embed URLCreate 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 projectDelete a project.
Get projectGet one project.
Get project analyticsGet visitor analytics for a project over a time range.
Get project analytics breakdownsGet a project's top visitor countries, devices, pages and other breakdowns over a time range.
Get project realtime analyticsGet a project's visitors over the last 30 minutes, minute by minute.
Get publish statusGet the status of a publish, and the reason if it failed.
Get security scanGet one security scan of a project.
Get workspaceGet one workspace.
Get workspace analyticsGet visitor analytics for a whole workspace over a time range.
Get workspace memberGet one member of a workspace.
Get workspace security insightsGet a workspace's security overview: the types of finding, how many projects have each, and how urgently they need review.
List personal data findingsList the personal data found in a project.
List projectsList projects; you can filter by workspace, visibility, whether they are published and who can open them.
List security scan findingsList the findings of one security scan.
List security scansList a project's security scans.
List workspace groupsList the groups in a workspace.
List workspace membersList a workspace's members; you can search, filter by role and sort.
List workspace security project inventoryList 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 workspacesList the workspaces you can access.
Publish projectPublish a project, optionally choosing who can open it.
Unpublish projectTake a project's published app offline.
Update projectChange a project's name or visibility.
Update publish settingsChange 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

Projectproject_idtextRequired
Project ID.
Parent originparent_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

Projectproject_idtextRequired
Project ID.

Outputs

dataobject
Lovable response data.
Example output
{
  "data": {}
}

Get project

Get one project. Needs a Lovable Business plan or higher.

Inputs

Projectproject_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

Projectproject_idtextRequired
Project ID.
Starts atstarts_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 atends_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.
Granularitygranularitytext
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

Projectproject_idtextRequired
Project ID.
Starts atstarts_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 atends_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

Projectproject_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

Projectproject_idtextRequired
Project ID.
Deployment iddeployment_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

Projectproject_idtextRequired
Project ID.
Scan idscan_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

Workspaceworkspace_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

Workspaceworkspace_idtextRequired
Workspace ID.
Starts atstarts_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 atends_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.
Granularitygranularitytext
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

Workspaceworkspace_idtextRequired
Workspace ID.
User idresource_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

Workspaceworkspace_idtextRequired
ID of the workspace to retrieve security insights for.
Review priorityreview_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

Projectproject_idtextRequired
Project ID.
Limitlimitnumber
Maximum number of items to return per page.From 1 to 100. Default: 50.
Cursorcursortext
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

Workspaceworkspace_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.
Visibilityvisibilitylist
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 publishedis_publishedtrue/false
Filter by whether the project is published. Omit for no filter.
Publish audiencepublish_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.
Queryquerytext
Search project names, generated descriptions, and owner names or email addresses. Terms shorter than 3 characters are ignored.
Limitlimitnumber
Maximum number of items to return per page.From 1 to 100. Default: 50.
Cursorcursortext
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

Projectproject_idtextRequired
Project ID.
Scan idscan_idtextRequired
Security scan ID returned by the list endpoint.
Limitlimitnumber
Maximum number of items to return per page.From 1 to 100. Default: 50.
Cursorcursortext
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

Projectproject_idtextRequired
Project ID.
Limitlimitnumber
Maximum number of items to return per page.From 1 to 100. Default: 50.
Cursorcursortext
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

Workspaceworkspace_idtextRequired
Workspace ID.
Limitlimitnumber
Maximum number of items to return per page.From 1 to 100. Default: 50.
Cursorcursortext
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

Workspaceworkspace_idtextRequired
Workspace ID.
Limitlimitnumber
Maximum number of items to return per page.From 1 to 100. Default: 50.
Cursorcursortext
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.
Queryquerytext
Search by display name, username, or email. Terms shorter than 3 characters are ignored.
Rolerolelist
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 bysort_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 ordersort_ordertext
Direction for sort_by. Defaults to descending. Requires sort_by.One of: asc, desc.
Scim managedscim_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

Workspaceworkspace_idtextRequired
Workspace ID.
Limitlimitnumber
Maximum number of items to return per page.From 1 to 100. Default: 50.
Cursorcursortext
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.
Queryquerytext
Free-text search across project name and owner. Terms shorter than 3 characters are ignored. A full project ID matches that project exactly.
Sort bysort_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 ordersort_ordertext
Direction for sort_by. Defaults to descending. Requires sort_by.One of: asc, desc.
Activity groupactivity_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 publishedis_publishedtrue/false
Filter by whether the project is published. Omit for no filter.
Visibilityvisibilitylist
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 piihas_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 connectorshas_connectorstrue/false
Filter by whether the project has a connected service. false selects projects without one. Omit for no filter.
Publish audiencepublish_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 priorityreview_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 idfinding_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

Limitlimitnumber
Maximum number of items to return per page.From 1 to 100. Default: 50.
Cursorcursortext
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

Projectproject_idtextRequired
Project ID.
Audienceaudiencetext
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 targetsaudience_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.
Namenametext
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

Projectproject_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

Projectproject_idtextRequired
Project ID.
Namenametext
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.
Visibilityvisibilitytext
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

Projectproject_idtextRequired
Project ID.
Audienceaudiencetext
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 targetsaudience_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": []
  }
}

On this page