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

​
Overview

Acknowledges an alert, indicating that it has been reviewed by the compliance team. This updates the alert status to ACKNOWLEDGED.

​
Endpoint

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

​
Authentication

Requires a valid API key in the Authorization header: 
Authorization: Bearer YOUR_API_KEY

​
Path Parameters

​
id
string
required
UUID of the alert to acknowledge

​
Response

​
success
boolean
Whether the operation was successful
​
alertId
string
UUID of the acknowledged alert
​
status
string
New status (ACKNOWLEDGED)
​
message
string
Success message

​
Example Request

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

​
Response Example

{
  "success": true,
  "alertId": "alert-uuid-123",
  "status": "ACKNOWLEDGED",
  "message": "Alert acknowledged successfully"
}

​
Use Cases

​
Acknowledge Alert in Workflow

async function acknowledgeAndAssign(alertId, assigneeId) {
  // First, acknowledge the alert
  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('Failed to acknowledge alert');
  }

  // Then assign to investigation
  console.log(`Alert ${alertId} acknowledged and ready for investigation`);

  return await ackResponse.json();
}

​
Error Responses

​
404 Not Found

{
  "error": "Alert not found",
  "alertId": "alert-uuid-123"
}

​
400 Bad Request

{
  "error": "Alert already acknowledged",
  "currentStatus": "ACKNOWLEDGED"
}

​
See Also