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

workspace_id
string
required

Workspace ID.

Response

OK

billing_period_ends_at
string<date-time> | null
required

Exclusive end of the current billing period. Null when no billing period is recorded or when the caller lacks permission to view workspace usage.

Example:

"2026-02-01T00:00:00Z"

billing_period_starts_at
string<date-time> | null
required

Inclusive start of the current billing period. Null when no billing period is recorded or when the caller lacks permission to view workspace usage.

Example:

"2026-01-01T00:00:00Z"

created_at
string<date-time>
required

When the workspace was created.

Example:

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

default_monthly_member_credit_limit
number<double> | null
required

Default monthly build-credit limit for members without an explicit per-member limit. Null when unset or when the caller lacks permission to view workspace usage. Active higher temporary limits can override it.

Example:

500

default_project_visibility
enum<string> | null
required

Default editor visibility for new projects, separate from published app access. workspace_edit: every workspace member, at the access level their workspace role grants. restricted: only the project owner, invited collaborators, and the workspace owner; requires Business or Enterprise, otherwise new projects fall back to workspace_edit. Null when no default is configured. More values may be added; clients must tolerate unknown values.

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

"workspace_edit"

description
string | null
required

Workspace description; null when none is set.

Example:

"Marketing site and internal tools for Acme."

enable_pii
boolean
required

Whether scanning for personally identifiable information (PII), such as names and email addresses, is enabled for workspace projects.

Example:

true

enforce_sso
boolean
required

Whether workspace members are required to sign in through single sign-on (SSO).

Example:

true

id
string
required

Workspace ID.

Example:

"workspace_01jw3k9m2xq8r5v0c7d4e6f2gh"

image_url
string | null
required

Workspace image URL; null when none is set.

Example:

"https://lovable.dev/cdn/workspaces/acme/avatar.png"

name
string
required

Workspace display name.

Example:

"Acme Inc"

num_projects
integer<int64>
required

Number of projects in the workspace.

Example:

12

num_seats
integer<int64> | null
required

Configured maximum number of workspace seats. Null when no positive workspace-specific seat limit is configured or when the caller lacks permission to view workspace usage.

Example:

25

plan
enum<string>
required

Plan tier. More values may be added; clients must tolerate unknown values.

Available options:
free,
pro,
business,
enterprise
Example:

"pro"

publishing_policy
enum<string> | null
required

Policy limiting who can view published apps or preventing publishing altogether; null when no audience restriction is configured. More values may be added; clients must tolerate unknown values.

Available options:
org_only,
workspace_only,
disabled,
null
Example:

"workspace_only"

updated_at
string<date-time>
required

When the workspace was last updated.

Example:

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