---
title: "Update workspace settings"
method: PATCH
path: "/v1/workspaces/{workspace_id}/settings"
tags: ["workspaces"]
---

# Update workspace settings

`PATCH /v1/workspaces/{workspace_id}/settings`

**Plan:** `Enterprise`

Updates writable workspace settings. Currently supports the default per-member monthly credit limit.

## Path parameters

- `workspace_id` string, required — Workspace ID.

## Request body

- V1UpdateWorkspaceSettingsNestedInputBody
  - `default_monthly_member_credit_limit` number, double, nullable — Default monthly credit cap applied to each member without an explicit per-member limit. Send a number >= 0 (0 blocks all member spend) to set it, or null to clear it (members are then bounded only by the workspace balance).

## Response `200`

OK

- V1WorkspaceSettingsBody
  - `billing_period_end_date` string, date-time — End of the current billing period.
  - `billing_period_start_date` string, date-time — Start of the current billing period.
  - `default_monthly_member_credit_limit` number, double — Default monthly credit cap applied to each member who has no explicit per-member limit. Absent when unset (members are bounded only by the workspace balance) or when the caller lacks permission to view workspace usage.
  - `default_project_visibility` string — Default visibility applied to new projects. One of: public, private, draft. Absent means the workspace effective default of private.
  - `enable_pii` boolean, required — Whether PII scanning is enabled across project resources.
  - `enforce_sso` boolean, required — Whether SSO is enforced for all members.
  - `id` string, required — Workspace ID.
  - `name` string, required — Workspace display name.
  - `num_seats` integer — Workspace-specific seat limit when one has been explicitly configured. Absent when the workspace runs on its plan's default (Enterprise workspaces are typically unlimited unless a per-tenant cap is set).
  - `plan` string, required — Plan tier. One of: free, pro, business, enterprise. More values may be added; clients must tolerate unknown values.
  - `publishing_policy` string — Restriction on what publish visibilities are allowed: workspace_only or disabled. Absent means no restriction.

## Other responses

- `401` — Missing or invalid API key.
- `402` — This operation or requested configuration requires a workspace plan that includes this feature.
- `403` — The key or caller lacks the required scope or permission.
- `406` — The Accept header excludes every media type this endpoint produces.
- `429` — Too many requests. Retry after the interval in Retry-After when present.
- `default` — Error. The response body uses the standard error envelope; status matches the HTTP status code and type is a machine-readable error code.

---

[API](https://skmtc.net/lovable/apis/lovable-api.md) · [All operations](https://skmtc.net/lovable/apis/lovable-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lovable/lovable-api/revisions/aa8d44585147/schema)