Listar escalaciones
Lista los casos en que un agente le pidió ayuda a una persona, filtrados por estado, miembro del equipo, tarea y fecha, con la pregunta, el motivo y el resultado.
Elige el estado
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, comoinvalid_statusoinvalid_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
API key for authentication. Keys are prefixed with nxr_live_.
Parámetros de consulta
open: waiting for a person. overdue: open and past the expected response time. resolved: every closed case, whatever the outcome. all: every case.
open, overdue, resolved, all Only escalations whose lead is currently assigned to this user ID. Cannot be combined with unassigned_only.
true returns only escalations whose lead has no assigned teammate.
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.
Only escalations created at or after this time. Accepts YYYY-MM-DD (read as midnight UTC) or an ISO 8601 date-time.
Only escalations created at or before this time. Accepts YYYY-MM-DD (read as midnight UTC) or an ISO 8601 date-time.
Page size.
1 <= x <= 100Rows to skip.
x >= 0Respuesta
A page of escalations and the total that match.
true The status filter applied.
open, overdue, resolved, all Escalations that match the filters, across every page.
x >= 01 <= x <= 100x >= 0