> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# iLert

> iLert is an incident response platform for managing alerts, on-call schedules, escalations, incidents, and status pages.

![iLert logo](https://mintcdn.com/composio-preview/tIuAovF9-7pXq2wA/images/toolkits/ilert.svg?fit=max\&auto=format\&n=tIuAovF9-7pXq2wA\&q=85\&s=36ff1c3dcda6c72892c27bfc51bfcd44)

* **Category:** it operations
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 8
* **Triggers:** 0
* **Slug:** `ILERT`
* **Version:** 00000000\_00

## Tools

> [accordion] Get Alert
>
> **Slug:** `ILERT_GET_ALERT`
>
> Get one iLert alert by its numeric ID, optionally expanding escalation rules, the next escalation user, or custom details.
>
> #### Input Parameters
>
> **include** `array`
>
> Optional alert expansions. Supported values are escalationRules, nextEscalationUser, and customDetails.
>
> **alert\_id** `integer` *required*
>
> Numeric iLert alert ID returned by List Alerts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Current User
>
> **Slug:** `ILERT_GET_CURRENT_USER`
>
> Return the authenticated iLert user, including identity, role, timezone, and active team context. Use this to verify who the API key represents before incident-response work.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Incident
>
> **Slug:** `ILERT_GET_INCIDENT`
>
> Get one iLert status incident by numeric ID, optionally including subscription state, affected teams, or history.
>
> #### Input Parameters
>
> **include** `array`
>
> Optional incident expansions. Supported values are subscribed, affectedTeams, and history.
>
> **incident\_id** `integer` *required*
>
> Numeric incident ID returned by List Incidents.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Alerts
>
> **Slug:** `ILERT_LIST_ALERTS`
>
> List iLert alerts with optional state, source, escalation-policy, responder, and report-time filters. Returns one page and a continuation cursor.
>
> #### Input Parameters
>
> **states** `array`
>
> Alert states to include: PENDING, ACCEPTED, or RESOLVED.
>
> **from\_time** `string`
>
> Inclusive ISO-8601 UTC lower bound based on the alert reportTime.
>
> **policy\_ids** `array`
>
> Escalation policy IDs to include.
>
> **source\_ids** `array`
>
> Alert source IDs to include.
>
> **until\_time** `string`
>
> ISO-8601 UTC upper bound based on the alert reportTime.
>
> **max\_results** `integer`
>
> Maximum alerts in this page (1-100).
>
> **next\_cursor** `string`
>
> Continuation cursor returned by this tool. It retains the filters and page size; omit it for the first page.
>
> **responder\_ids** `array`
>
> Responder user IDs to include.
>
> **include\_next\_escalation\_user** `boolean`
>
> Include the next escalation user in each alert.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Incidents
>
> **Slug:** `ILERT_LIST_INCIDENTS`
>
> List iLert status incidents with optional lifecycle-state, affected-service, and report-time filters. Returns one page and a continuation cursor.
>
> #### Input Parameters
>
> **states** `array`
>
> Incident states to include: INVESTIGATING, IDENTIFIED, MONITORING, or RESOLVED.
>
> **from\_time** `string`
>
> Inclusive ISO-8601 UTC lower bound based on reportTime.
>
> **until\_time** `string`
>
> ISO-8601 UTC upper bound based on reportTime.
>
> **max\_results** `integer`
>
> Maximum incidents in this page (1-100, or 1-25 when include\_subscribed is true).
>
> **next\_cursor** `string`
>
> Continuation cursor returned by this tool. It retains the filters and page size; omit it for the first page.
>
> **service\_ids** `array`
>
> Affected service IDs to include.
>
> **include\_subscribed** `boolean`
>
> Include whether the current user is subscribed to each incident.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List On Calls
>
> **Slug:** `ILERT_LIST_ON_CALLS`
>
> Find who is on call for selected escalation policies, schedules, users, and a time window of at most three months. Returns one page and a continuation cursor.
>
> #### Input Parameters
>
> **expand** `string ("policy" | "escalationPolicy" | "user")`
>
> Entity to expand in results: policy, escalationPolicy, or user.
>
> **user\_id** `integer`
>
> User ID to filter duties.
>
> **timezone** `string`
>
> IANA timezone used to render results.
>
> **from\_time** `string`
>
> ISO-8601 UTC start; defaults upstream to the current time.
>
> **policy\_id** `integer`
>
> Escalation policy ID to filter duties.
>
> **until\_time** `string`
>
> ISO-8601 UTC end after from\_time. The range may span at most three calendar months.
>
> **max\_results** `integer`
>
> Maximum on-call duties in this page (1-250).
>
> **next\_cursor** `string`
>
> Continuation cursor returned by this tool. It retains the filters and page size; omit it for the first page.
>
> **schedule\_id** `integer`
>
> On-call schedule ID to filter duties.
>
> **policy\_level** `object`
>
> Filter by one escalation-policy level using an object with integer id (policy ID) and integer level (escalation level), for example \{id: 123, level: 2}. Cannot be combined with policy\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Resources
>
> **Slug:** `ILERT_LIST_RESOURCES`
>
> List one incident-response resource catalog: services, teams, escalation policies, or maintenance windows. Use returned IDs as filters or references in alert, incident, and on-call tools.
>
> #### Input Parameters
>
> **include** `array`
>
> Services only: optional subscribed, uptime, or incidents expansions.
>
> **from\_time** `string`
>
> Maintenance windows only: ISO-8601 UTC lower bound.
>
> **member\_id** `integer`
>
> Teams only: return teams containing this one member ID.
>
> **source\_ids** `array`
>
> Maintenance windows only: filter by alert source IDs.
>
> **until\_time** `string`
>
> Maintenance windows only: ISO-8601 UTC upper bound.
>
> **max\_results** `integer`
>
> Maximum resources in this page (1-20).
>
> **next\_cursor** `string`
>
> Continuation cursor returned by this tool. It retains the resource type, filters, and page size; omit it for the first page.
>
> **service\_ids** `array`
>
> Maintenance windows only: filter by service IDs.
>
> **resource\_type** `string ("services" | "teams" | "escalation_policies" | "maintenance_windows")` *required*
>
> Catalog to list: services, teams, escalation\_policies, or maintenance\_windows.
>
> **maintenance\_state** `string ("OPEN" | "CLOSED")`
>
> Maintenance windows only: OPEN or CLOSED.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Schedules
>
> **Slug:** `ILERT_LIST_SCHEDULES`
>
> List iLert on-call schedules, optionally expanding current or next shifts and schedule definitions. Returns one page and a continuation cursor.
>
> #### Input Parameters
>
> **include** `array`
>
> Optional expansions: scheduleLayers, shifts, currentShift, nextShift, or past. scheduleLayers applies to recurring schedules; shifts and past apply to static schedules.
>
> **max\_results** `integer`
>
> Maximum schedules in this page (1-20).
>
> **next\_cursor** `string`
>
> Continuation cursor returned by this tool. It retains expansions and page size; omit it for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
