Skip to main content
GET
cURL

Authorizations

Lovable-API-Key
string
header
required

Lovable API key. Send its value in the Lovable-API-Key header.

Headers

Lovable-Version
string

Stable API version to serve, as a YYYY-MM-DD date. Omit for the oldest supported stable version, currently 2026-09-11.

Lovable-Beta
string

Comma-separated beta revision strings to enable on top of the stable version.

Query Parameters

workspace_id
string[]
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.

Required array length: 1 - 10 elements
visibility
enum<string>[]

Filter by the visibility field. Repeat to match any of the values. Omit to include every level you can access.

Available options:
restricted,
workspace_edit,
workspace_view
is_published
boolean

Filter by whether the project is published. Omit for no filter.

publish_audience
enum<string>[]

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.

Available options:
public,
workspace,
custom
query
string

Search project names, generated descriptions, and owner names or email addresses. Terms shorter than 3 characters are ignored.

Maximum string length: 1000
limit
integer<int64>
default:50

Maximum number of items to return per page.

Required range: 1 <= x <= 100
cursor
string

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.

Response

OK

data
object[]
required

Items in this page. Empty when there are none.

pagination
object
required

Whether more results are available and the cursor to fetch the next page.