curl --request GET \
--url 'https://api.lovable.dev/v1/workspaces/workspace-id' \
--header 'Lovable-API-Key: lov_your-api-key' \
--header 'Lovable-Version: 2026-09-11'{
"billing_period_ends_at": "2026-02-01T00:00:00Z",
"billing_period_starts_at": "2026-01-01T00:00:00Z",
"created_at": "2026-01-15T09:30:00Z",
"default_monthly_member_credit_limit": 500,
"default_project_visibility": "workspace_edit",
"description": "Marketing site and internal tools for Acme.",
"enable_pii": true,
"enforce_sso": true,
"id": "workspace_01jw3k9m2xq8r5v0c7d4e6f2gh",
"image_url": "https://lovable.dev/cdn/workspaces/acme/avatar.png",
"name": "Acme Inc",
"num_projects": 12,
"num_seats": 25,
"plan": "pro",
"publishing_policy": "workspace_only",
"updated_at": "2026-01-15T09:30:00Z"
}{
"detail": "validation failed",
"errors": [
{
"location": "body.members",
"message": "expected array length >= 1"
}
],
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 400,
"title": "Bad Request",
"type": "invalid_request"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 401,
"title": "Authorization header required",
"type": "unauthorized"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 402,
"title": "You need to upgrade your plan to access this feature",
"type": "payment_required"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 403,
"title": "You don't have the permissions to perform this action",
"type": "forbidden"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 404,
"title": "Not Found",
"type": "workspace_not_found"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 406,
"title": "This endpoint produces application/json. Send a matching Accept header, */*, or omit the header.",
"type": "not_acceptable"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 429,
"title": "Too Many Requests",
"type": "rate_limited"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 503,
"title": "Request timed out",
"type": "request_timeout"
}{
"detail": "validation failed",
"errors": [
{
"location": "body.workspace_id",
"message": "expected string"
}
],
"props": {
"finding_refs": [
"supabase/finding-1"
]
},
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 429,
"title": "Too Many Requests",
"type": "rate_limited"
}Get workspace
Plan: Business or higher
Scope: workspaces:read
Returns workspace details, security and publishing policies, seat count, billing period, and default member credit limit. Usage fields are null without permission to view workspace usage. Member details, including roles, are on GET /v1/workspaces//members. The num_projects count is eventually consistent and may not immediately reflect project creation or deletion.
curl --request GET \
--url 'https://api.lovable.dev/v1/workspaces/workspace-id' \
--header 'Lovable-API-Key: lov_your-api-key' \
--header 'Lovable-Version: 2026-09-11'{
"billing_period_ends_at": "2026-02-01T00:00:00Z",
"billing_period_starts_at": "2026-01-01T00:00:00Z",
"created_at": "2026-01-15T09:30:00Z",
"default_monthly_member_credit_limit": 500,
"default_project_visibility": "workspace_edit",
"description": "Marketing site and internal tools for Acme.",
"enable_pii": true,
"enforce_sso": true,
"id": "workspace_01jw3k9m2xq8r5v0c7d4e6f2gh",
"image_url": "https://lovable.dev/cdn/workspaces/acme/avatar.png",
"name": "Acme Inc",
"num_projects": 12,
"num_seats": 25,
"plan": "pro",
"publishing_policy": "workspace_only",
"updated_at": "2026-01-15T09:30:00Z"
}{
"detail": "validation failed",
"errors": [
{
"location": "body.members",
"message": "expected array length >= 1"
}
],
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 400,
"title": "Bad Request",
"type": "invalid_request"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 401,
"title": "Authorization header required",
"type": "unauthorized"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 402,
"title": "You need to upgrade your plan to access this feature",
"type": "payment_required"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 403,
"title": "You don't have the permissions to perform this action",
"type": "forbidden"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 404,
"title": "Not Found",
"type": "workspace_not_found"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 406,
"title": "This endpoint produces application/json. Send a matching Accept header, */*, or omit the header.",
"type": "not_acceptable"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 429,
"title": "Too Many Requests",
"type": "rate_limited"
}{
"detail": null,
"errors": null,
"props": null,
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 503,
"title": "Request timed out",
"type": "request_timeout"
}{
"detail": "validation failed",
"errors": [
{
"location": "body.workspace_id",
"message": "expected string"
}
],
"props": {
"finding_refs": [
"supabase/finding-1"
]
},
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736",
"status": 429,
"title": "Too Many Requests",
"type": "rate_limited"
}Authorizations
Lovable API key. Send its value in the Lovable-API-Key header.
Headers
Stable API version to serve, as a YYYY-MM-DD date. Omit for the oldest supported stable version, currently 2026-09-11.
Comma-separated beta revision strings to enable on top of the stable version.
Path Parameters
Workspace ID.
Response
OK
Exclusive end of the current billing period. Null when no billing period is recorded or when the caller lacks permission to view workspace usage.
"2026-02-01T00:00:00Z"
Inclusive start of the current billing period. Null when no billing period is recorded or when the caller lacks permission to view workspace usage.
"2026-01-01T00:00:00Z"
When the workspace was created.
"2026-01-15T09:30:00Z"
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.
500
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.
restricted, workspace_edit, workspace_view, null "workspace_edit"
Workspace description; null when none is set.
"Marketing site and internal tools for Acme."
Whether scanning for personally identifiable information (PII), such as names and email addresses, is enabled for workspace projects.
true
Whether workspace members are required to sign in through single sign-on (SSO).
true
Workspace ID.
"workspace_01jw3k9m2xq8r5v0c7d4e6f2gh"
Workspace image URL; null when none is set.
"https://lovable.dev/cdn/workspaces/acme/avatar.png"
Workspace display name.
"Acme Inc"
Number of projects in the workspace.
12
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.
25
Plan tier. More values may be added; clients must tolerate unknown values.
free, pro, business, enterprise "pro"
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.
org_only, workspace_only, disabled, null "workspace_only"
When the workspace was last updated.
"2026-01-15T09:30:00Z"
Was this page helpful?