Criar ou atualizar workspace
PUT/v1/workspaces
Upsert. Recebe o mesmo corpo do POST mais as chaves de busca id e external_id, casadas nessa ordem. Um match é atualizado in place e responde 200 — campos ausentes do corpo mantêm o valor armazenado. Sem chave, ou sem match, cria o workspace exatamente como o POST faria e responde 201. Escopo: a organização do workspace do token — todo workspace vivo dessa organização é alcançável; um fora dela é 404. Um token cujo workspace não tem organização enxerga só a si mesmo. Exige token src=system; external_id não pode ser alterado em um workspace casado (409).
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 404
- 409
- 422
Sucesso.
Sucesso.
O corpo falhou na validação Zod. error.details carrega formErrors/fieldErrors.
Falha de autenticação (JWT ou mTLS ausente/inválido).
Autenticado, mas o escopo é insuficiente ou o recurso está fora de alcance.
Recurso não encontrado ou filtrado por soft-delete.
Restrição de unicidade violada (ex.: external_id ou email da inbox já em uso).
Validação do corpo que requer contexto do lado do servidor (ex.: domínio da inbox incompatível).