Actualizar la configuración de la empresa

Actualizar la configuración de la empresa

PATCH 
/config

Permisos requeridos

Dashboard: necesitas al menos uno de estos permisos.

• config.manage

API Keys: necesitas al menos uno de estos permisos.

• config.api.manage

Actualiza los parámetros configurables de la empresa.

Para workflows.secrets, los valores son write-only:

• envía value para crear o reemplazar un secret
• las respuestas devolverán configured en lugar del valor almacenado

Prueba este endpoint

Responses

200

Configuración actualizada exitosamente

202

La mutación ya fue aplicada por la autoridad de configuración, pero su proyección local en sandbox sigue pendiente. No se debe repetir la mutación: reintentarla crearía o modificaría el recurso una segunda vez.

El cuerpo es el mismo que devuelve la respuesta exitosa de este endpoint, con el recurso ya mutado, así que puedes usarlo sin esperar la proyección. Consulta el Location firmado solo si necesitas leer el recurso desde sandbox inmediatamente después.

Cuando la proyección alcanza a la autoridad dentro de la misma request, el endpoint responde con su estado exitoso habitual y X-Soyio-Projection-State: applied en lugar de este 202.

Response Headers

X-Soyio-Projection-State

Estado de la proyección local. En este 202 siempre es pending.

X-Soyio-Shared-Company

Identificador de la empresa cuya configuración fue modificada.

X-Soyio-Shared-Config-Version

Versión global que la proyección local debe alcanzar.

Retry-After

Segundos sugeridos antes de consultar nuevamente el estado.

Location

Ruta firmada para consultar el estado de la proyección sin credenciales adicionales.

401

Error de autenticación

403

Acceso prohibido por permisos, módulo o entorno no habilitado

409

Otra mutación sobre la misma configuración compartida se aplicó al mismo tiempo y esta request no se aplicó. No se guardó ningún cambio, así que puedes reintentar la misma request de forma segura.

A diferencia del 202 de proyección pendiente, este 409 indica que la mutación no tuvo efecto.

422

Error de validación, o un cambio bloqueado porque dejaría cuentas sin poder entrar al dashboard. Distingue los casos por el campo reason, presente solo en el segundo.