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.

Path Parameters

project_id
string
required

Project ID.

Response

OK

created_at
string<date-time> | null
required

When the project was created; null when unavailable.

Example:

"2026-01-15T09:30:00Z"

description
string | null
required

AI-written summary of what the project does; null until the agent has completed a response for the project.

Example:

"A landing page for Acme with a hero, features, and pricing."

id
string
required

Project ID.

Example:

"prj_01jw3k9m2xq8r5v0c7d4e6f2gh"

is_published
boolean
required

Whether the project is published.

Example:

true

last_edited_at
string<date-time> | null
required

When the project last received an edit or a user chat message; null when neither has happened.

Example:

"2026-01-15T09:30:00Z"

latest_commit_sha
string | null
required

SHA of the latest commit; null before the first commit.

Example:

"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"

latest_screenshot_url
string | null
required

URL of the latest screenshot; null until one has been captured.

Example:

"https://screenshot2.lovable.dev/acme-landing-page.png"

name
string | null
required

Human-readable project name; null when none is set.

Example:

"Acme Landing Page"

owner_id
string | null
required

Project owner user UUID, matching the OAuth subject for clients using derived UUIDs. Null when unavailable.

Example:

"404666c6-b533-5d2c-9768-c425bf40559b"

preview_url
string | null
required

URL of the project's main preview. Serves the latest successful preview build at the same address across commits; it is not pinned to a commit or draft. Uses the workspace's branded hostname unless the project opts out, and may change when branding changes. Null when the environment has no preview host; a URL does not mean a preview build is ready. Contains no authentication token; opening it requires a Lovable login unless the project is publicly remixable. To embed it from a third-party origin, use POST /v1/projects/{project_id}/embed-url.

Example:

"https://id-preview--fa8b85cf-b9ff-4f1c-989a-74c32d1326f4.lovable.app"

publish_audience
enum<string> | null
required

Who can open the published app: the audience set via POST or PATCH /v1/projects/{project_id}/publish; null while the app is not published. More values may be added; clients must tolerate unknown values.

Available options:
public,
workspace,
custom,
null
Example:

"public"

publish_audience_targets
object[]
required

Groups and users who can open the published app when publish_audience is custom; empty for other audiences and while the app is offline. Users granted through invitations or organization membership are included; organization-wide access and pending email invitations are not listed.

visibility
enum<string> | null
required

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). Null when no setting is stored. Published app access is configured separately via publish_audience. More values may be added; clients must tolerate unknown values.

Available options:
restricted,
workspace_edit,
workspace_view,
null
Example:

"workspace_edit"

workspace_id
string
required

Workspace the project belongs to.

Example:

"workspace_01jw3k9m2xq8r5v0c7d4e6f2gh"