--- title: Grafana API Integration on Truto slug: grafana category: Application Development canonical: "https://truto.one/integrations/detail/grafana/" --- # Grafana API Integration on Truto **Category:** Application Development **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Grafana account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Grafana.** The Proxy API is a 1-to-1 mapping of the Grafana API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Automate user provisioning and role management across customer Grafana instances** — Identity governance and internal developer portal SaaS companies can programmatically create users, assign roles, and manage team memberships in their customers' Grafana instances — ensuring access controls stay in sync with organizational changes without manual intervention. - **Sync organizational structure into Grafana for dashboard access control** — HR tech and workforce management platforms can mirror team structures into Grafana, automatically granting engineers the right level of access (Admin, Editor, Viewer) to relevant dashboards when they join, move between, or leave teams. - **Streamline engineer onboarding and offboarding in observability tooling** — SaaS platforms managing developer lifecycle events can ensure that when an engineer is onboarded or offboarded in their system, the corresponding Grafana user account is created or deactivated immediately — reducing security risk and manual ops overhead. - **Centralize user directory management across observability tools** — Platform engineering SaaS products that manage access across multiple tools can include Grafana as part of a unified user directory sync, giving customers a single control plane for identity across their entire stack. ## What you can build - **Automated Grafana user provisioning from your platform** — Automatically create Grafana user accounts with the correct roles when new team members are added in your product. - **Real-time team membership sync** — Mirror team and organization structures from your platform into Grafana Teams, so dashboard access permissions stay current without manual configuration. - **Bulk user offboarding across connected Grafana instances** — When an employee is deactivated in your system, automatically revoke their Grafana access across all connected customer instances in a single workflow. - **Role-based access audit dashboard** — Pull user and role data from customer Grafana instances to surface access audit reports directly in your product, helping customers meet compliance requirements. - **Cross-tool user directory reconciliation** — Compare Grafana user directories against your platform's source of truth to flag orphaned accounts, role mismatches, or missing users that need attention. ## FAQs ### How does authentication work for Grafana integrations through Truto? Grafana supports API key-based authentication and service account tokens for programmatic access. Truto handles the auth flow so your end users can securely connect their Grafana instances — whether self-hosted or on Grafana Cloud — without you managing token storage or rotation. ### Does Truto support both Grafana Cloud and self-hosted Grafana instances? Yes. Since Grafana exposes the same HTTP API whether it's running on Grafana Cloud or self-hosted, Truto can connect to both as long as the instance is reachable and the user provides valid credentials. ### What user data can I read and write through the Grafana integration? Through the Unified User Directory API, you can work with Grafana user profiles (email, login, name), role assignments (Admin, Editor, Viewer), and organizational context. Specific tool support for Grafana is built on request — contact Truto to scope your exact requirements. ### Are there rate limits on the Grafana API I should be aware of? Grafana Cloud enforces rate limits that vary by plan tier. Self-hosted instances may have custom rate limits or none at all. Truto handles pagination and request management, but high-volume operations should account for potential throttling on Cloud instances. ### What if I need Grafana API capabilities beyond user management, like dashboards or annotations? Truto builds integration tools on request. While the current Unified API coverage maps to User Directory (users, roles, teams), additional Grafana API capabilities — such as dashboards, annotations, alerting, and data sources — can be scoped and built based on your use case. ### How does Truto handle differences between Grafana API versions? Truto abstracts away version-specific quirks in the Grafana HTTP API. Whether your customers run an older self-hosted version or the latest Grafana Cloud release, Truto normalizes the responses so your integration code stays consistent.