Crear o actualizar workspace
PUT/v1/workspaces
Upsert. Recibe el mismo cuerpo que POST más las claves de búsqueda id y external_id, comparadas en ese orden. Una coincidencia se actualiza in situ y devuelve 200 — los campos ausentes del cuerpo conservan el valor almacenado. Sin clave, o sin coincidencia, crea el workspace exactamente como lo haría POST y devuelve 201. Alcance: la organización del workspace del token — todo workspace vivo de esa organización es alcanzable; uno fuera de ella es 404. Un token cuyo workspace no tiene organización solo se ve a sí mismo. Requiere un token src=system; external_id no puede cambiarse en un workspace coincidente (409).
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 404
- 409
- 422
Éxito.
Éxito.
El cuerpo no superó la validación de Zod. error.details contiene formErrors/fieldErrors.
Fallo de autenticación (JWT o mTLS ausente o inválido).
Autenticado, pero el scope es insuficiente o el recurso está fuera de alcance.
Recurso no encontrado o excluido por soft-delete.
Se violó una restricción de unicidad (por ejemplo, external_id o el email del inbox ya en uso).
Validación del cuerpo que requiere contexto del lado del servidor (por ejemplo, dominio del inbox no coincide).