Lists unhandled-escalation events across the tenant, newest first.
Lists recent unhandled escalations. Use sinceMs to change the default lookback window. Each item includes agentId, topicId/participantId and the failure reason. Reading does not retry the escalation.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The tenant identifier
Query Parameters
Optional Application filter. Naming an Application the caller cannot open is a 403.
uuidOptional agent filter, asserted through the agent's owning Application.
Optional lower bound (Unix ms) on the event time. Defaults to now minus the lookback window.
int64The maximum number of items to return per page
int32int32Opaque pagination token returned by an external service. Pass it back unchanged rather than interpreting it as an offset.
Response Body
curl -X GET "https://api.fruxon.com/v1/tenants/string/unhandledEscalations"{
"items": [
{
"id": "00000000-0000-0000-0000-000000000000",
"agentId": "string",
"networkId": "00000000-0000-0000-0000-000000000000",
"sessionId": "string",
"topicId": "00000000-0000-0000-0000-000000000000",
"participantId": "00000000-0000-0000-0000-000000000000",
"customerAddress": "string",
"detail": "string",
"reason": "string",
"cause": "NO_OPERATOR_CONFIGURED",
"createdAt": 0
}
],
"nextPageToken": "string",
"totalCount": 0
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}Records the human decision and reopens the parent task for worker resume
On approve, the parent execution is requeued from the parked step and the tool call proceeds with its original arguments; on reject, the rejection text is fed back into the flow as the tool result so the agent can react to (or surface) the operator's reasoning. The responder identity is captured from the caller's auth context, not the request body, so audit trails reflect the real user. Requires Admin role on the agent to prevent arbitrary viewers from authorizing privileged tool calls; to abandon a request without resuming, use `POST .../pendingApprovals/{pendingApproval}:cancel`.
Lists all available alert types with labels and descriptions.
Catalog of alert types available to agents, with identifiers, labels and severities. Shared across workspaces and stable across requests; clients may cache it.