latestOpenAPI 3.1.02026-08-223391355.6 KB

aa8d44585147

workspaces

Update workspace settings

Plan: Enterprise

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

patch/v1/workspaces/{workspace_id}/settings

Path parameters

workspace_idstring required

Workspace ID.

Request body

default_monthly_member_credit_limitnumber 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

billing_period_end_datestring date-time

End of the current billing period.

billing_period_start_datestring date-time

Start of the current billing period.

default_monthly_member_credit_limitnumber 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_visibilitystring

Default visibility applied to new projects. One of: public, private, draft. Absent means the workspace effective default of private.

enable_piiboolean required

Whether PII scanning is enabled across project resources.

enforce_ssoboolean required

Whether SSO is enforced for all members.

idstring required

Workspace ID.

namestring required

Workspace display name.

num_seatsinteger

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).

planstring required

Plan tier. One of: free, pro, business, enterprise. More values may be added; clients must tolerate unknown values.

publishing_policystring

Restriction on what publish visibilities are allowed: workspace_only or disabled. Absent means no restriction.