Saltar al contenido principal
POST
Crear exportación de eventos de riesgo
Envíe un objeto como { "format": "json", "event_types": ["signal", "decision"] }. Guarde export_id y consulte el punto final de lectura. Una respuesta 202 confirma que el trabajo existe; no confirma que el procesamiento esté completo. Las exportaciones de riesgo contienen señales y decisiones de riesgo del espacio de trabajo. No configuran el reenvío automático de registros de auditoría. Consulte integración SIEM para la distinción.

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Cuerpo

application/json
format
enum<string>
predeterminado:json
Opciones disponibles:
json,
csv,
cef,
leef
event_types
enum<string>[]

Categorías de registro a incluir. Vacío u omitido incluye ambos; estos no son nombres de proveedores o subtipos de señales de riesgo.

Maximum array length: 2
Opciones disponibles:
signal,
decision
since
string<date-time>

Límite inferior inclusivo. Por defecto, 30 días antes de hasta.

until
string<date-time>

Límite superior exclusivo. Por defecto, la hora de la solicitud. Rango máximo: 366 días; los rangos futuros son rechazados.

Respuesta

Trabajo persistente; consulte su export_id

export_id
string<uuid>
status
enum<string>
Opciones disponibles:
pending,
running,
complete,
failed
format
enum<string>
Opciones disponibles:
json,
csv,
cef,
leef
since
string<date-time>
until
string<date-time>
event_types
enum<string>[]
Opciones disponibles:
signal,
decision
record_count
integer
created_at
string<date-time>
completed_at
string<date-time>
error_message
string
export_data

Evidencia JSON analizada para formato json; texto para CSV, CEF y LEEF. Presente solo cuando esté completo.