Atualizar organização
PATCH/v1/organization
A organização vem só do token (o claim org, como em GET /v1/me): não há lista nem {id}, e nenhum header, query ou corpo escolhe outra. Nível de organização: X-Workspace-Id não é necessário. Altera o perfil comum a todos os workspaces: custom_metadata. Chaves desconhecidas, os campos de identidade (id, public_id, external_id, slug, document_type, document_number) e os espelhos da conta Kobana (name, email, phone — sincronizados a partir dela, por isso não são editáveis aqui) são ignorados. Citar uma configuração comercial da Kobana (cortesia, liberação sem assinatura, limites, parceiro, entitlements) é recusado com 403 FORBIDDEN (error.details.fields). Exige a permissão settings.update (dono e admin). Toda alteração fica no log de auditoria da organização.
Request
Responses
- 200
- 400
- 401
- 403
Sucesso.
O corpo falhou na validação Zod. error.details carrega formErrors/fieldErrors.
Falha de autenticação (JWT ausente ou inválido).
Autenticado, mas o escopo ou a permissão não bastam, ou o corpo cita uma configuração comercial (FORBIDDEN, error.details.fields).