# Grafana Data Sources API

**Canonical:** https://apis.io/apis/grafana-com/grafana-com-data-sources-api/  
**Provider:** Grafana — https://apis.io/providers/grafana-com/  
**Base URL:** /api  
**Documentation:** https://grafana.com/docs/grafana-cloud/developer-resources/api-reference/cloud-api/

Grafana Data Sources API is one of 49 APIs that [Grafana](https://apis.io/providers/grafana-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Data Sources. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

If you are running Grafana Enterprise and have Fine-grained access control enabled, for some endpoints you would need to have relevant permissions. Refer to specific resources to understand what permissions are required.

## Operations (20)

| Method | Path | Summary |
|---|---|---|
| GET | `/datasources` | Get all data sources |
| POST | `/datasources` | Create a data source |
| GET | `/datasources/correlations` | Gets all correlations |
| GET | `/datasources/id/{name}` | Get data source Id by Name. This function will be removed in the future |
| GET | `/datasources/name/{name}` | Get a single data source by Name. This function will be removed in the future |
| DELETE | `/datasources/name/{name}` | Delete an existing data source by name. |
| GET | `/datasources/proxy/uid/{uid}/{datasource_proxy_route}` | Data source proxy GET calls |
| POST | `/datasources/proxy/uid/{uid}/{datasource_proxy_route}` | Data source proxy POST calls |
| DELETE | `/datasources/proxy/uid/{uid}/{datasource_proxy_route}` | Data source proxy DELETE calls |
| GET | `/datasources/uid/{sourceUID}/correlations` | Gets all correlations originating from the given data source |
| POST | `/datasources/uid/{sourceUID}/correlations` | Add correlation |
| GET | `/datasources/uid/{sourceUID}/correlations/{correlationUID}` | Gets a correlation |
| PATCH | `/datasources/uid/{sourceUID}/correlations/{correlationUID}` | Updates a correlation |
| GET | `/datasources/uid/{uid}` | Get a single data source by UID |
| PUT | `/datasources/uid/{uid}` | Update an existing data source |
| DELETE | `/datasources/uid/{uid}` | Delete an existing data source by UID |
| DELETE | `/datasources/uid/{uid}/correlations/{correlationUID}` | Delete a correlation |
| GET | `/datasources/uid/{uid}/health` | Sends a health check request to the plugin datasource identified by the UID |
| GET | `/datasources/uid/{uid}/resources/{datasource_proxy_route}` | Fetch data source resources |
| POST | `/ds/query` | DataSource query metrics with expressions |

## Machine-readable artifacts (32)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/grafana-com/refs/heads/main/openapi/grafana-com-data-sources-api-openapi.yml
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/
- **Authentication** — https://grafana.com/docs/grafana/latest/developers/http_api/authentication/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/dashboard/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/dashboard_versions/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/dashboard_permissions/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/dashboard_public/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/folder/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/folder_dashboard_search/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/folder_permissions/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/data_source/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/datasource_permissions/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/datasource_lbac_rules/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/alerting_provisioning/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/annotations/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/org/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/user/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/team/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/team_sync/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/preferences/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/access_control/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/serviceaccount/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/sso-settings/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/admin/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/licensing/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/reporting/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/query_and_resource_caching/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/library_element/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/correlations/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/snapshot/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/short_url/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/query_history/

## Other Grafana APIs (12)

- [Grafana Cloud API](https://apis.io/apis/grafana-com/grafana-cloud-api/)
- [Grafana Loki HTTP API](https://apis.io/apis/grafana-com/loki-http-api/)
- [Grafana Mimir HTTP API](https://apis.io/apis/grafana-com/mimir-http-api/)
- [Grafana Tempo HTTP API](https://apis.io/apis/grafana-com/tempo-http-api/)
- [Grafana Pyroscope HTTP API](https://apis.io/apis/grafana-com/pyroscope-http-api/)
- [Grafana k6 Cloud API](https://apis.io/apis/grafana-com/k6-cloud-api/)
- [Grafana OnCall API](https://apis.io/apis/grafana-com/oncall-api/)
- [Grafana Synthetic Monitoring API](https://apis.io/apis/grafana-com/synthetic-monitoring-api/)
- [Grafana Access Control API](https://apis.io/apis/grafana-com/grafana-com-access-control-api/)
- [Grafana Admin API](https://apis.io/apis/grafana-com/grafana-com-admin-api/)
- [Grafana Admin Ldap API](https://apis.io/apis/grafana-com/grafana-com-admin-ldap-api/)
- [Grafana Admin Provisioning API](https://apis.io/apis/grafana-com/grafana-com-admin-provisioning-api/)

## Tags

Data Sources

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/grafana-com/grafana-com-data-sources-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/grafana-com/.
