Skip to main content
POST
http://api.gu1.ai
/
risk-matrices
Crear Matriz de Riesgo
curl --request POST \
  --url http://api.gu1.ai/risk-matrices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "category": "<string>",
  "status": "<string>",
  "scoringConfig": {},
  "triggers": [
    {}
  ],
  "tags": [
    {}
  ]
}
'

​
Descripción General

Crea una nueva matriz de riesgo con configuración de puntuación y activadores opcionales.

​
Cuerpo de la Solicitud

​
name
string
required
Nombre de la matriz de riesgo
​
description
string
Descripción de la matriz de riesgo
​
category
string
default:"custom"
Categoría: aml, kyc, fraud, sanctions, transaction_monitoring, customer_risk, regulatory, custom
​
status
string
default:"draft"
Estado: draft, active, shadow, inactive
​
scoringConfig
object
Configuración de puntuación con umbrales
​
triggers
array
Array de configuraciones de activadores
​
tags
array
Array de etiquetas para organización

​
Configuración de Activadores

Cada activador puede tener: 
{
  "name": "Activador de Alto Riesgo",
  "description": "Crear investigación cuando el riesgo es alto",
  "condition": {
    "field": "riskScore",
    "operator": "gte",
    "value": 80
  },
  "action": "create_investigation",
  "priority": "HIGH"
}

​
Ejemplo

curl -X POST http://api.gu1.ai/risk-matrices \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Matriz de Monitoreo de Transacciones",
    "description": "Monitorear transacciones de alto riesgo",
    "category": "transaction_monitoring",
    "status": "active",
    "scoringConfig": {
      "minScore": 0,
      "maxScore": 100,
      "thresholds": {
        "low": 30,
        "medium": 60,
        "high": 80
      }
    },
    "triggers": [
      {
        "name": "Activador de Riesgo Crítico",
        "description": "Crear investigación automáticamente para riesgo crítico",
        "condition": {
          "field": "riskScore",
          "operator": "gte",
          "value": 90
        },
        "action": "create_investigation",
        "priority": "CRITICAL"
      },
      {
        "name": "Alerta de Riesgo Medio",
        "description": "Crear alerta para riesgo medio",
        "condition": {
          "field": "riskScore",
          "operator": "between",
          "value": [60, 89]
        },
        "action": "create_alert",
        "priority": "MEDIUM"
      }
    ],
    "tags": ["transaction", "aml"]
  }'

​
Respuesta

{
  "riskMatrix": {
    "id": "rm-new-123",
    "name": "Matriz de Monitoreo de Transacciones",
    "status": "active",
    "triggers": [/* ... */]
  },
  "usingDefaultStrategy": false
}

​
Acciones de Activadores

  • create_alert: Crear una alerta
  • create_investigation: Crear una investigación
  • send_notification: Enviar notificación al equipo
  • block_entity: Bloquear entidad del procesamiento
  • request_approval: Solicitar aprobación manual
  • escalate: Escalar al supervisor

​
Ver También