Skip to navigation
ReferenceAPI Referenceworkspaces

Update Workspace

Update a workspace’s name, color palette index, and/or slug. Admin only.

All fields are optional — supply only the fields you want to change. slug follows the same validation rules as on create (lowercase kebab-case, 1–50 characters, no reserved words). Returns 409 if the new slug is already claimed by another workspace, 422 if the slug format is invalid or reserved. Re-setting the workspace’s current slug to itself never returns 409.

Only workspace admins may call this endpoint; other members receive 404 (same as not-found, to avoid leaking membership details to non-members).

Authentication

AuthorizationBearer
Clerk JWT token

Path parameters

workspace_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.
namestring or nullOptional1-200 characters
New workspace name. Omit to leave unchanged.
slugstring or nullOptional<=512 characters

New slug (lowercase kebab-case, 1–50 characters). Omit to leave unchanged. Returns 409 if taken, 422 if invalid or reserved.

color_idxinteger or nullOptional

New color palette index (0–6). Omit to leave unchanged.

routing_price_sensitivitydouble or nullOptional0-1

New voice-selection price/quality balance (0.0 = pure quality, 1.0 = pure price, 0.5 = balanced). Omit to leave unchanged.

routing_llm_fitboolean or nullOptional
New setting for whether automatic voice selection also weighs content fit. Omit to leave unchanged.

Response

Successful Response
dataobject
metaobject

Errors

409
Conflict Error
422
Unprocessable Entity Error