Requires the admin or owner role and a session JWT. API keys are rejected with 401. A member gets 403 forbidden with details.requiredRole: "admin" — see Role errors. Any plan.
Path Parameters
NameDescription
orgId:stringpathRequired
The organization ID.
Request Body
Send at least one field. Any other key is ignored and not stored.
NameDescription
name:stringbody
Display name, 2–100 characters after trimming.
slug:stringbody
URL slug, 2–50 characters of lowercase letters, digits and -. Must not be used by any other workspace, including deleted ones whose slug hasn't been released.
Response — 200 OK
role is your own role in the workspace. The change is recorded in the audit log as org.updated.
Error Responses
400 Bad Request
Returned when neither field is sent, or a value is out of range. The code is validation_error, with each problem in details.issues.
401 Unauthorized
unauthorized for a missing, invalid or expired token (or an API key); session_revoked when the session has been signed out.
403 Forbidden
Returned when you are a member of the workspace:
json
{
"error": {
"code": "forbidden",
"message": "Only workspace admins can change workspace settings.",