Saltar al contenido principal
POST
Crear un hallazgo

Autorizaciones

Authorization
string
header
requerido

Envía Authorization: Bearer YOUR_API_KEY. La clave corresponde a una sola organización.

Cuerpo

application/json
title
string
requerido
Required string length: 1 - 255
description
object

TipTap Documento JSON.

status
enum<string>
predeterminado:open
Opciones disponibles:
open,
acknowledged,
resolved,
ignored
priority
enum<string>
predeterminado:none
Opciones disponibles:
none,
low,
medium,
high,
urgent
tags
string[]
findingType
integer | null
Rango requerido: 0 <= x <= 2147483647
conversationIds
string<uuid>[]

UUID de conversación opcionales para adjuntar al nuevo hallazgo en la creación. Cada uno debe ser una conversación de tu organización (si no, 400 conversation_not_found, con los ids en unknownConversationIds). Se vinculan aunque no indiques una ventana analizada; la ventana añade la instantánea de volumen.

Maximum array length: 1000
analyzedFromDate
string<date-time>

El inicio opcional del intervalo de tiempo analizado resume este hallazgo.

analyzedToDate
string<date-time>

Final opcional del intervalo de tiempo analizado este hallazgo resume.

Respuesta

Hallazgo creado. En un plan sin Hallazgos el cuerpo incluye además una cadena warning; si el cuerpo traía campos que este endpoint ignora, incluye un arreglo warnings que los nombra.

id
string<uuid>
requerido
title
string
requerido
status
enum<string>
requerido
Opciones disponibles:
open,
acknowledged,
resolved,
ignored
priority
enum<string>
requerido
Opciones disponibles:
none,
low,
medium,
high,
urgent
tags
string[]
requerido
createdAt
string<date-time>
requerido
updatedAt
string<date-time>
requerido
description
object

TipTap Documento JSON.

findingType
integer | null
assigneeUserId
string<uuid> | null
warning
string
warnings
string[]