Skip to main content
POST
/
intelligence
/
alerts
/
{id}
/
acknowledge
Reconocer Alerta
curl --request POST \
  --url http://api.gu1.ai/intelligence/alerts/{id}/acknowledge \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "alertId": "<string>",
  "status": "<string>",
  "message": "<string>"
}

​
Descripción General

Reconoce una alerta, indicando que ha sido revisada por el equipo de cumplimiento. Esto actualiza el estado de la alerta a ACKNOWLEDGED.

​
Endpoint

POST http://api.gu1.ai/intelligence/alerts/{id}/acknowledge

​
Autenticación

Requiere una clave API válida en el encabezado de Autorización: 
Authorization: Bearer YOUR_API_KEY

​
Parámetros de Ruta

​
id
string
required
UUID de la alerta a reconocer

​
Respuesta

​
success
boolean
Si la operación fue exitosa
​
alertId
string
UUID de la alerta reconocida
​
status
string
Nuevo estado (ACKNOWLEDGED)
​
message
string
Mensaje de éxito

​
Ejemplo de Solicitud

curl -X POST http://api.gu1.ai/intelligence/alerts/alert-uuid-123/acknowledge \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Ejemplo de Respuesta

{
  "success": true,
  "alertId": "alert-uuid-123",
  "status": "ACKNOWLEDGED",
  "message": "Alerta reconocida exitosamente"
}

​
Casos de Uso

​
Reconocer Alerta en Flujo de Trabajo

async function acknowledgeAndAssign(alertId, assigneeId) {
  // Primero, reconocer la alerta
  const ackResponse = await fetch(
    `http://api.gu1.ai/intelligence/alerts/${alertId}/acknowledge`,
    {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    }
  );

  if (!ackResponse.ok) {
    throw new Error('Error al reconocer la alerta');
  }

  // Luego asignar a investigación
  console.log(`Alerta ${alertId} reconocida y lista para investigación`);

  return await ackResponse.json();
}

​
Respuestas de Error

​
404 No Encontrado

{
  "error": "Alerta no encontrada",
  "alertId": "alert-uuid-123"
}

​
400 Solicitud Incorrecta

{
  "error": "Alerta ya reconocida",
  "currentStatus": "ACKNOWLEDGED"
}

​
Ver También