Update organization
PATCH/v1/organization
The organization comes from the token alone (its org claim, as in GET /v1/me) — there is no list and no {id}, and no header, query or body picks another one. Organization-level: X-Workspace-Id is not needed. Changes the profile shared by every workspace: custom_metadata. Unknown keys, the identity fields (id, public_id, external_id, slug, document_type, document_number) and the mirrors of the Kobana account (name, email, phone — kept in sync from it, so they are not editable here) are ignored. Naming one of Kobana's commercial settings (courtesy, plan bypass, limits, partner, entitlements) is refused with 403 FORBIDDEN (error.details.fields). Needs the settings.update permission (owner and admin). Every change is recorded in the organization audit log.
Request
Responses
- 200
- 400
- 401
- 403
Success.
Body failed Zod validation. error.details carries formErrors/fieldErrors.
Authentication failed (missing or invalid JWT).
Authenticated but the scope or the permission is insufficient, or the body names a commercial setting (FORBIDDEN, error.details.fields).