# Lovable

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

App · 24 actions. Web page: https://docs.lodol.com/docs/integrations/lovable

## Actions

### 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_id`, text, required): Project ID.
- Parent origin (`parent_origin`, text, required): 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**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "data": {
    "embed_url": "example",
    "expires_at": "example"
  }
}
```

### Delete project

Delete a project. Needs a Lovable Business plan or higher.

**Inputs**

- Project (`project_id`, text, required): Project ID.

**Outputs**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "data": {}
}
```

### Get project

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

**Inputs**

- Project (`project_id`, text, required): Project ID.

**Outputs**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "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_id`, text, required): Project ID.
- Starts at (`starts_at`, date and time, required): 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_at`, date and time, required): 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 (`granularity`, text): 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**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "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_id`, text, required): Project ID.
- Starts at (`starts_at`, date and time, required): 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_at`, date and time, required): 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**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "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_id`, text, required): Project ID.

**Outputs**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "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_id`, text, required): Project ID.
- Deployment id (`deployment_id`, text, required): Deployment ID returned by POST /v1/projects/{project_id}/publish.

**Outputs**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "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_id`, text, required): Project ID.
- Scan id (`scan_id`, text, required): Security scan ID returned by the list endpoint.

**Outputs**

- `data` (object): Status and timing of the security scan. Retrieve findings from this scan's paginated findings endpoint.

**Example output**

```json
{
  "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_id`, text, required): Workspace ID.

**Outputs**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "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_id`, text, required): Workspace ID.
- Starts at (`starts_at`, date and time, required): 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_at`, date and time, required): 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 (`granularity`, text): 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**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "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_id`, text, required): Workspace ID.
- User id (`resource_user_id`, text, required): User ID returned by the workspace members endpoint.

**Outputs**

- `data` (object): The active workspace member.

**Example output**

```json
{
  "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_id`, text, required): ID of the workspace to retrieve security insights for.
- Review priority (`review_priority`, list): 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**

- `data` (object): Workspace security insights with project and membership counts, review priorities, and finding types.

**Example output**

```json
{
  "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_id`, text, required): Project ID.
- Limit (`limit`, number): Maximum number of items to return per page. From 1 to 100. Default: `50`.
- Cursor (`cursor`, text): 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**

- `data` (object): Personal data findings ordered by found_at, newest first, with label ID breaking ties. Includes open, ignored, and fixed findings.

**Example output**

```json
{
  "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_id`, list, required): 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 (`visibility`, list): 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_published`, true/false): Filter by whether the project is published. Omit for no filter.
- Publish audience (`publish_audience`, list): 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 (`query`, text): Search project names, generated descriptions, and owner names or email addresses. Terms shorter than 3 characters are ignored.
- Limit (`limit`, number): Maximum number of items to return per page. From 1 to 100. Default: `50`.
- Cursor (`cursor`, text): 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**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "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_id`, text, required): Project ID.
- Scan id (`scan_id`, text, required): Security scan ID returned by the list endpoint.
- Limit (`limit`, number): Maximum number of items to return per page. From 1 to 100. Default: `50`.
- Cursor (`cursor`, text): 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**

- `data` (object): 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**

```json
{
  "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_id`, text, required): Project ID.
- Limit (`limit`, number): Maximum number of items to return per page. From 1 to 100. Default: `50`.
- Cursor (`cursor`, text): 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**

- `data` (object): 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**

```json
{
  "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_id`, text, required): Workspace ID.
- Limit (`limit`, number): Maximum number of items to return per page. From 1 to 100. Default: `50`.
- Cursor (`cursor`, text): 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**

- `data` (object): Paginated workspace groups, sorted by name.

**Example output**

```json
{
  "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_id`, text, required): Workspace ID.
- Limit (`limit`, number): Maximum number of items to return per page. From 1 to 100. Default: `50`.
- Cursor (`cursor`, text): 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 (`query`, text): Search by display name, username, or email. Terms shorter than 3 characters are ignored.
- Role (`role`, list): 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_by`, text): 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_order`, text): Direction for sort_by. Defaults to descending. Requires sort_by. One of: `asc`, `desc`.
- Scim managed (`scim_managed`, true/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**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "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_id`, text, required): Workspace ID.
- Limit (`limit`, number): Maximum number of items to return per page. From 1 to 100. Default: `50`.
- Cursor (`cursor`, text): 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 (`query`, text): 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_by`, text): 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_order`, text): Direction for sort_by. Defaults to descending. Requires sort_by. One of: `asc`, `desc`.
- Activity group (`activity_group`, list): 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_published`, true/false): Filter by whether the project is published. Omit for no filter.
- Visibility (`visibility`, list): 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_pii`, true/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_connectors`, true/false): Filter by whether the project has a connected service. false selects projects without one. Omit for no filter.
- Publish audience (`publish_audience`, list): 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_priority`, list): 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_id`, list): 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**

- `data` (object): Projects with security finding counts, review priorities, activity counts, and publishing details.

**Example output**

```json
{
  "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 (`limit`, number): Maximum number of items to return per page. From 1 to 100. Default: `50`.
- Cursor (`cursor`, text): 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**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "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_id`, text, required): Project ID.
- Audience (`audience`, text): 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_targets`, list): 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 (`name`, text): 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**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "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_id`, text, required): Project ID.

**Outputs**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "data": {}
}
```

### Update project

Change a project's name or visibility. Needs a Lovable Business plan or higher.

**Inputs**

- Project (`project_id`, text, required): Project ID.
- Name (`name`, text): 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 (`visibility`, text): 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**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "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_id`, text, required): Project ID.
- Audience (`audience`, text): 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_targets`, list): 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**

- `data` (object): Lovable response data.

**Example output**

```json
{
  "data": {
    "audience": "public",
    "audience_targets": []
  }
}
```
