Documentation Index
Fetch the curated documentation index at: https://grafana_com_website/llms.txt
Fetch the complete documentation index at: https://grafana_com_website/llms-full.txt
Use this file to discover all available pages before exploring further.
STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: /docs/grafana-cloud/alerting-and-irm/irm/reference.md (append .md) or send Accept: text/markdown to /docs/grafana-cloud/alerting-and-irm/irm/reference/. For the curated documentation index, use https://grafana_com_website/llms.txt. For the complete documentation index, use https://grafana_com_website/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


