Lister les alertes de sécurité

GET/api/public/v1/alerts

Paginated list of in-app security alerts (notifications with type_key='security_alert_raised') joined with their underlying verdict + agent metadata. Filters: severity[], tool_name[], agent_platform[], agent_label[], rule_id[], status[] (unread/read/dismissed), timestamp_gte/timestamp_lte. Search: ?search=<term> matches title, body, and rule_id. Sort keys: created_at (default), title, final_severity, tool_name, agent_label, status.

cURL

curl --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/alerts' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    'https://app.openlatch.ai/api/public/v1/alerts',
    method='GET',
    headers={
        'Authorization': 'Bearer ' + os.environ['OPENLATCH_API_KEY'],
    },
)
with urllib.request.urlopen(request) as response:
    text = response.read().decode()
    print(json.dumps(json.loads(text), indent=2) if text else response.status)

Bash

#!/usr/bin/env bash
set -euo pipefail

curl -sS --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/alerts' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY" | jq .

PowerShell

$headers = @{
  Authorization = "Bearer $env:OPENLATCH_API_KEY"
}
Invoke-RestMethod -Method GET -Uri 'https://app.openlatch.ai/api/public/v1/alerts' -Headers $headers | ConvertTo-Json -Depth 20

Autorisation

Rôle dans l’organisation	Ce point de terminaison
owner	Autorisé
admin	Autorisé
editor	Autorisé
viewer	Autorisé

Une clé porte le rôle que son propriétaire détient dans l’organisation. Voir Authentification.

Portée de clé d’API : alerts:read

Paramètres de requête

Paramètre	Type	Description
search	string or null
severity	array of string or null
tool_name	array of string or null
agent_platform	array of string or null
agent_label	array of string or null
rule_id	array of string or null
status	array of string or null
timestamp_gte	string (date-time) or null
timestamp_lte	string (date-time) or null
sort_by	string
sort_order	string — one of asc, desc
page	integer
page_size	integer

Réponse

• 200 OK — l’appel a réussi.
• 401 Unauthorized — UNAUTHORIZED
• 402 Payment Required — license_expired
• 403 Forbidden — FEATURE_DISABLED, FORBIDDEN, INSUFFICIENT_SCOPE
• 422 Unprocessable Content — INVALID_ID, VALIDATION_ERROR
• 429 Too Many Requests — TOO_MANY_REQUESTS
• 500 Internal Server Error — INTERNAL_SERVER_ERROR, tenant_isolation_violation
• 503 Service Unavailable — FEATURE_STATE_UNAVAILABLE, SERVICE_UNAVAILABLE

Champs de la réponse

Champ	Type	Description
data	array of object	Obligatoire.
data[].agent_id	string or null
data[].agent_label	string or null
data[].agent_platform	string or null
data[].body	string or null
data[].created_at	string (date-time)	Obligatoire.
data[].detection_tool_slug	string or null
data[].event_id	string or null
data[].final_severity	string — one of low, medium, high, critical or null
data[].final_verdict	string or null
data[].is_test	boolean
data[].notification_id	string (uuid)	Obligatoire.
data[].rule_id	string or null
data[].status	string — one of unread, read, dismissed	Obligatoire.
data[].title	string	Obligatoire.
data[].tool_name	string or null
page	integer	Obligatoire.
page_size	integer	Obligatoire.
total	integer	Obligatoire.

Exemple de réponse

{
  "data": [
    {
      "agent_id": "agt_01jbwa2k1vfrn9y42xhgxhmzj2",
      "agent_label": "string",
      "agent_platform": "string",
      "body": "string",
      "created_at": "2026-01-15T14:32:05Z",
      "detection_tool_slug": "string",
      "event_id": "evt_01jbwa2k1vfrn9y42xhgxhmzj2",
      "final_severity": "low",
      "final_verdict": "string",
      "is_test": false,
      "notification_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "rule_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "status": "unread",
      "title": "string",
      "tool_name": "release-bot"
    }
  ],
  "page": 1,
  "page_size": 3,
  "total": 3
}

Voir aussi

• DELETE Supprimer définitivement une alerte de sécurité
• PATCH Écarter une alerte de sécurité
• PATCH Marquer une alerte de sécurité comme lue