Skip to main content
PATCH
/
entities
/
toggle-status-monitoring
Activar o desactivar monitoreo por entidad e integración
curl --request PATCH \
  --url http://api.gu1.ai/entities/toggle-status-monitoring \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entityId": "<string>",
  "integrationCode": "<string>",
  "active": true,
  "riskMatrixId": {}
}
'
PATCH http://api.gu1.ai/entities/toggle-status-monitoring
Endpoint genérico para fijar si una entidad está o no en monitoreo continuo para un integrationCode (la lógica aguas abajo depende del código; hoy: Güeno sanciones globales).

​
Autenticación

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Requiere permiso de edición sobre la entidad indicada en entityId.

​
Cuerpo (JSON)

​
entityId
string
required
UUID de la entidad (debe pertenecer a tu organización).
​
integrationCode
string
required
Código de integración / enrichment. Soportado hoy: global_gueno_sanctions_enrichment.
Otros valores → 400 con UNSUPPORTED_MONITORING_INTEGRATION.
​
active
boolean
  • true — incluir en monitoreo continuo cuando la org y el flujo lo permitan (reinclusión).
  • false — excluir (equivalente a monitoringOptOut: true en la ruta deprecada). Hay que enviar al menos uno de active o riskMatrixId.
​
riskMatrixId
string | null
Opcional. Solo sanciones globales Güeno. UUID de una matriz de riesgo de la org, o null para quitar el override por suscripción (el screening diario vuelve a usar la matriz global de la entidad). Si se fija un UUID, solo esa matriz se usa en la corrida de reglas disparada por monitoreo (p. ej. trigger_monitoring_completed); no se mezcla con la matriz asignada a la entidad. No modifica entities.riskMatrixId.

​
Respuestas de error

HTTPCódigo (ejemplo)Cuándo
404ENTITY_NOT_FOUNDLa entidad no existe en la org.
400UNSUPPORTED_MONITORING_INTEGRATIONintegrationCode sin handler, o riskMatrixId en código no soportado.
400INVALID_RISK_MATRIXMatriz inexistente, archivada o de otra org.

​
Ejemplo — excluir del monitoreo Güeno

curl -sS -X PATCH "http://api.gu1.ai/entities/toggle-status-monitoring" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "integrationCode": "global_gueno_sanctions_enrichment",
    "active": false
  }'

​
Ruta deprecada (compatibilidad)

PATCH /entities/{id}/gueno-sanctions-monitoring-opt-out con { "monitoringOptOut": boolean } sigue disponible pero está deprecada; equivale a este endpoint con active: !monitoringOptOut.