Skip to main content
GET
List escalations
Una escalación es un caso en que un agente le pidió ayuda a una persona. En la app, estos casos aparecen en Inbox. Consulta Gestiona escalaciones en Inbox.

Elige el estado

En cada fila, status es pending mientras el caso está abierto, y resolution_outcome indica cómo se cerró, por ejemplo resolved_manually o discarded.

Filtra la lista

assigned_to en la respuesta es el dueño del lead hoy, no el que tenía cuando se escaló.

Recorre los resultados

limit va de 1 a 100 (25 por defecto) y offset salta filas. total es la cantidad de casos que cumplen los filtros en todas las páginas.

Antes de empezar

  • Las claves MCP necesitan leads:read. Las claves REST con acceso completo no necesitan nada más.
  • Este endpoint solo lee. Para responder o cerrar un caso, usa Inbox.
  • Los errores devuelven un código estable en error, como invalid_status o invalid_limit. Tradúcelo a tu propio mensaje.
  • Una IA conectada al servidor MCP de Nexor lee la misma lista con la herramienta list_escalations.

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Parámetros de consulta

status
enum<string>
predeterminado:open

open: waiting for a person. overdue: open and past the expected response time. resolved: every closed case, whatever the outcome. all: every case.

Opciones disponibles:
open,
overdue,
resolved,
all
assigned_to
string<uuid>

Only escalations whose lead is currently assigned to this user ID. Cannot be combined with unassigned_only.

unassigned_only
boolean
predeterminado:false

true returns only escalations whose lead has no assigned teammate.

workflow_id
string<uuid>

Task ID (workflow in the API). Only escalations raised by this task. A malformed ID returns 400 invalid_workflow_id, and a task outside this account returns 404 workflow_not_found.

date_from
string<date-time>

Only escalations created at or after this time. Accepts YYYY-MM-DD (read as midnight UTC) or an ISO 8601 date-time.

date_to
string<date-time>

Only escalations created at or before this time. Accepts YYYY-MM-DD (read as midnight UTC) or an ISO 8601 date-time.

limit
integer
predeterminado:25

Page size.

Rango requerido: 1 <= x <= 100
offset
integer
predeterminado:0

Rows to skip.

Rango requerido: x >= 0

Respuesta

A page of escalations and the total that match.

success
enum<boolean>
requerido
Opciones disponibles:
true
status
enum<string>
requerido

The status filter applied.

Opciones disponibles:
open,
overdue,
resolved,
all
total
integer
requerido

Escalations that match the filters, across every page.

Rango requerido: x >= 0
limit
integer
requerido
Rango requerido: 1 <= x <= 100
offset
integer
requerido
Rango requerido: x >= 0
escalations
object[]
requerido
Última modificación el 29 de septiembre de 2026