---
title: "iLert integration for LuumenAI"
url: "https://www.luumen.ai/integrations/ilert/"
entity: SoftwareIntegration
category: "Monitoring & observability"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# iLert integration for LuumenAI

Read iLert alerts, incidents, and on-call coverage without leaving the terminal

## What LuumenAI can do with iLert

LuumenAI connects to iLert with an API token and exposes 8 tools (8 read-only). Every tool is read-only, so it can answer questions from iLert but cannot change anything in it.

## Key facts

- Authentication: API token
- Tools available: 8 tools (8 read-only)
- Plan: available on all plans
- Category: Monitoring & observability

## About iLert with LuumenAI

Connect iLert with an API key and ask who is on call right now, what alerts are open, and how an incident got where it is. Luumen reads alerts, status incidents, schedules, escalation policies, services, and teams, and answers in the terminal. This integration is read-only: no tools here change anything in iLert.

## Example tools

Read-only (8 in total):

- `ILERT_GET_ALERT` — Get one iLert alert by its numeric ID, optionally expanding escalation rules, the next escalation user, or custom details.
- `ILERT_GET_CURRENT_USER` — Return the authenticated iLert user, including identity, role, timezone, and active team context.
- `ILERT_GET_INCIDENT` — Get one iLert status incident by numeric ID, optionally including subscription state, affected teams, or history.
- `ILERT_LIST_ALERTS` — List iLert alerts with optional state, source, escalation-policy, responder, and report-time filters.
- `ILERT_LIST_INCIDENTS` — List iLert status incidents with optional lifecycle-state, affected-service, and report-time filters.
- `ILERT_LIST_ON_CALLS` — Find who is on call for selected escalation policies, schedules, users, and a time window of at most three months.
- `ILERT_LIST_RESOURCES` — List one incident-response resource catalog: services, teams, escalation policies, or maintenance windows.
- `ILERT_LIST_SCHEDULES` — List iLert on-call schedules, optionally expanding current or next shifts and schedule definitions.

## Frequently asked questions

### How does LuumenAI connect to iLert?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in iLert on its own?

No. Every one of the 8 tools is read-only, so LuumenAI can answer questions from iLert but cannot change anything in it.

### Is there an audit trail?

Every call to iLert is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/ilert/