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
Headers
Path Parameters
Response
OK
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"
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"
Was this page helpful?