Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/grafana-cloud/alerting-and-irm/irm/reference.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana-cloud/alerting-and-irm/irm/reference/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
Reference
This section provides detailed API documentation for programmatically interacting with different components of the Grafana IRM platform.
API reference guides
Grafana IRM brings together functionality from both Grafana OnCall and Grafana Incident. Each component maintains its own API structure, which you can access through the following reference guides:
Grafana OnCall API
The OnCall API provides endpoints for managing alert groups, escalation policies, schedules, and on-call rotations. Use this API to:
- Manage alert groups and their lifecycle
- Configure escalation chains and policies
- Handle on-call schedules and shift swaps
- Set up integrations with monitoring systems
- Configure notification rules and channels
The OnCall API uses a RESTful design pattern and is ideal for automating incident response workflows and notification management.
Grafana Incident API
The Incident API provides endpoints for managing the incident lifecycle, including declarations, updates, and resolutions. Use this API to:
- Declare new incidents
- Manage incident status and lifecycle
- Add and update incident tasks
- Attach and manage incident roles
- Record and retrieve incident timelines
The Incident API uses a JSON/HTTP RPC design pattern and enables you to build custom workflows around incident management processes.
Was this page helpful?
Related resources from Grafana Labs


