---
title: Hosted Grafana API
description: Coralogix provides a secure Grafana API for creating, editing, exporting, importing, querying, and other Grafana API operations. Through Grafana APIs, you can manage your hosted Grafana dashboards.
url: https://coralogix.com/docs/developer-portal/apis/grafana/hosted-grafana-api/
product: data-exploration
feature: Grafana
feature_id: grafana
feature_identifier: data-exploration/grafana
last_updated: '2026-07-06'
---

# Hosted Grafana API

Coralogix provides a secure **hosted Grafana API** for creating, editing, exporting, importing, querying, and other Grafana API operations. Through Grafana APIs, you can manage your hosted Grafana dashboards.

## Prerequisites

To use the Grafana API to query your dashboard, you will need:

* To [create](https://coralogix.com/docs/user-guides/account-management/api-keys/api-keys.md) a personal or team API key. It’s recommended to use permission presets, as they are automatically updated with all relevant permissions. Alternatively, you can manually add individual permissions.

  | Preset  | Action                               | Description                                            |
  | ------- | ------------------------------------ | ------------------------------------------------------ |
  | Grafana | `GRAFANA:READ`<br />`GRAFANA:UPDATE` | View Grafana Dashboards<br />Manage Grafana Dashboards |

* A Coralogix [domain](https://coralogix.com/docs/user-guides/account-management/account-settings/coralogix-domain.md)

## **HTTP Request for Your Hosted Grafana**

The API key should be added as Coralogix token with each HTTP request. Your Coralogix Domain will be used to construct the Grafana API endpoint specific to your account.

The API request should contain the following:

* Headers:

  * ‘token:`<cx_api_key>`’

  * ‘Content-type: application/json‘

* URL: <!-- -->https\://api./grafana/api

## **Examples**

* GET Home Dashboard

```
curl --location --request GET 'https://api.eu2.coralogix.com/grafana/api/dashboards/home' \

--header 'Content-type: application/json' \

--header 'Authorization: Bearer <cx_api_key>' \
```

* Search all dashboards in your team:

```
curl --location --request GET 'https://api.eu2.coralogix.com/grafana/api/search' \

--header 'Content-type: application/json' \

--header 'Authorization: Bearer <cx_api_key>' \
```

* Get a dashboard and panels by uid:

```
curl --location --request GET 'https://api.eu2.coralogix.com/grafana/api/dashboards/uid/<UID>' \

--header 'Content-type: application/json' \

--header 'Authorization: Bearer <cx_api_key>' \
```

* Post Dashboard - create and update existing dashboards:

```
curl --location 'https://api.eu2.coralogix.com/grafana/api/dashboards/db' \

--header 'Content-Type: application/json' \

--header 'Authorization: Bearer <cx_api_key>' \

--data '<Dashboard JSON>'
```

* GET Annotations:

```
curl --location --request POST 'https://api.eu2.coralogix.com/grafana/api/dashboards/db' \

--header 'Content-type: application/json' \

--header 'Authorization: Bearer <cx_api_key>' \

--data-binary "@path/to/file"
```

## Additional Resources

* [Grafana’s HTTP API Reference](https://grafana.com/docs/grafana/v9.0/developers/http_api/)

* Grafana API supports the Host Grafana features.