Listar incidencias detectadas por IA

api-referenceGET

GEThttps://analytics.flowsery.com/analytics/api/v1/issues

Lista las incidencias que la IA de Flowsery detectó al analizar las grabaciones de sesión, deduplicadas entre sesiones y ordenadas por gravedad.

Token Bearer (token de workspace o clave API de sitio web)

Los tokens de espacio de trabajo necesitan un selector de sitio web

Los tokens de API del espacio de trabajo pueden acceder a todos los sitios web del espacio de trabajo. Pase <code>websiteId</code> o <code>domain</code> para que Flowsery sepa qué sitio web consultar o mutar. Las claves API del sitio web ya están destinadas a un sitio web, por lo que se puede omitir el selector.

Selector de sitios web

Parametro	Tipo	Descripcion
`websiteId`	`string`	ID del sitio web para usar con un token de API del espacio de trabajo. Omitir al autenticarse con una clave API de sitio web.
`domain`	`string`	Sitio web domain para usar con un token API de espacio de trabajo cuando no se proporciona websiteId. Omitir al autenticarse con una clave API de sitio web.

Las incidencias suspendidas se ocultan por defecto

La lista excluye las incidencias suspendidas salvo que se soliciten explícitamente con <code>status=suspended</code>.

Parametros opcionales

Parametro	Tipo	Descripcion
`status`	`string`	Filtra por estado de flujo de trabajo: open, in_progress, resolved o suspended. Si se omite, se devuelven todos los estados excepto suspended.
`severity`	`string`	Filtra por gravedad: low, medium, high o critical.
`search`	`string`	Búsqueda de texto sobre títulos y descripciones de incidencias. Máx. 200 caracteres.
`sort`	`string`	severity (predeterminado) ordena primero las incidencias más graves; recency ordena por lastSeenAt, las más recientes primero.
`limit`	`number`	Máximo de incidencias a devolver (predeterminado: 100, máx: 1000).
`offset`	`number`	Filas a omitir para paginacion (min. 0, predeterminado: 0).

Campos de respuesta

Parametro	Tipo	Descripcion
`id`	`string`	Identificador único de la incidencia. Pásalo como issueId a los endpoints de detalle y actualización.
`websiteId`	`string`	Sitio web al que pertenece la incidencia.
`title`	`string`	Resumen breve del problema generado por IA.
`description`	`string`	Explicación generada por IA de qué falla y cómo afecta a los visitantes.
`severity`	`string`	Valoración de impacto asignada por la IA: low, medium, high o critical.
`status`	`string`	Estado de flujo de trabajo: open, in_progress, resolved o suspended.
`sessionsCount`	`number`	Cuántas sesiones analizadas encontraron esta incidencia.
`firstSeenAt`	`string`	Cuándo se detectó la incidencia por primera vez en una grabación.
`lastSeenAt`	`string`	Grabación más reciente en la que apareció la incidencia.
`stepsToReplicate`	`array`	Pasos ordenados de reproducción, derivados de las grabaciones donde ocurrió la incidencia.
`sampleRecordingId`	`string`	Grabación que mejor demuestra la incidencia.
`externalTicketProvider / externalTicketKey / externalTicketUrl`	`string \| null`	Ticket vinculado en un gestor externo, o null cuando no hay ningún ticket vinculado.
`counts`	`object`	Totales de incidencias por estado (open, inProgress, resolved) del sitio web seleccionado, independientemente de la ventana de paginación.

Listar todas las incidencias

curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/issues \
  --header 'Authorization: Bearer <api-key>'

Filtrar incidencias críticas abiertas

curl --request GET \
  --url "https://analytics.flowsery.com/analytics/api/v1/issues?status=open&severity=critical&search=checkout&sort=recency" \
  --header 'Authorization: Bearer <api-key>'

200

{
  "status": "success",
  "data": [
    {
      "id": "iss_64f1c2a9e8b4d90012ab34cd",
      "websiteId": "flid_abc123",
      "title": "Checkout button unresponsive on mobile Safari",
      "description": "Tapping the checkout button produces no navigation or feedback. Visitors tap repeatedly and abandon the cart.",
      "severity": "critical",
      "status": "open",
      "sessionsCount": 14,
      "firstSeenAt": "2026-08-02T09:14:31.000Z",
      "lastSeenAt": "2026-08-27T18:40:05.000Z",
      "stepsToReplicate": [
        "Open the store on an iPhone in Safari",
        "Add any product to the cart",
        "Tap the checkout button on the cart page"
      ],
      "sampleRecordingId": "rec_9f8e7d6c5b4a",
      "externalTicketProvider": "linear",
      "externalTicketKey": "SHOP-142",
      "externalTicketUrl": "https://linear.app/acme/issue/SHOP-142"
    },
    {
      "id": "iss_64f1c2a9e8b4d90012ab34ce",
      "websiteId": "flid_abc123",
      "title": "Pricing table overflows on narrow viewports",
      "description": "The pricing table renders outside the viewport below 375px, hiding the yearly plan column.",
      "severity": "medium",
      "status": "in_progress",
      "sessionsCount": 6,
      "firstSeenAt": "2026-08-10T12:03:12.000Z",
      "lastSeenAt": "2026-08-25T07:55:48.000Z",
      "stepsToReplicate": [
        "Open /pricing on a viewport narrower than 375px",
        "Scroll horizontally inside the pricing table"
      ],
      "sampleRecordingId": "rec_1a2b3c4d5e6f",
      "externalTicketProvider": null,
      "externalTicketKey": null,
      "externalTicketUrl": null
    }
  ],
  "counts": {
    "open": 5,
    "inProgress": 2,
    "resolved": 11
  },
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 7
  }
}