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/incident-api/auth.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana-cloud/alerting-and-irm/irm/reference/incident-api/auth/. 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.
Authentication
To access the Grafana Incident JSON/HTTP RPC API, you will need to create a Service Account and a Service account token from the Administration section in the sidebar.
Learn more about Service accounts and tokens in the Administration documentation.
Get a service account token
An Admin user can generate a service account token through the Grafana web interface:
- Create a dedicated Service account for API access. It is recommended that you create a service account for each application.
- Give it the
Editorrole, so it is able to take action. - Add a token to the service account so the API can act on behalf of that account.
- Copy the token to your clipboard, and use it when making API calls.
Use the service account token
You will need to make HTTP requests with the following header:
Authorization: Bearer glsa_HOruNAb7SOiCdshU9algkrq7F...When using one of the official client libraries, you can provide this programmatically through environment variables or a secret manager.
Was this page helpful?
Related resources from Grafana Labs


