---
title: "SDKs and APIs for developers | Grafana Cloud documentation"
description: "Integrate Grafana Assistant into your plugins and external applications using the TypeScript SDK or HTTP APIs."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# SDKs and APIs for developers

Grafana Assistant provides APIs and SDKs for integrating AI-powered assistance into your plugins, applications, and external systems.

## Interactive documentation

For the best experience with live SDK examples:

1. Open **Grafana Assistant** from the main navigation
2. Click **Integration hub**
3. Explore examples with:
   
   - Live code you can try immediately
   - Copy-to-clipboard code snippets

## Integration options

Choose the integration approach that matches your needs:

### TypeScript SDK for Grafana plugins

The `@grafana/assistant` package provides a lightweight TypeScript SDK for integrating Assistant into Grafana plugins and apps. Use this when building Grafana plugins or extending the Grafana UI.

[**Learn more about the TypeScript SDK**](/docs/grafana-cloud/platform/grafana-assistant/reference/typescript-sdk)

### Go AI SDK for AI backends

The open source `github.com/grafana/ai-sdk` module provides Go building blocks for AI backends, including streaming text generation, tool calls, structured output, provider routing, and middleware. Use it when you are building a Go service or agent runtime rather than integrating with the Grafana Assistant UI.

Refer to the [Go AI SDK repository](https://github.com/grafana/ai-sdk) for installation and API details.

### Service account API access

Use Grafana service accounts when an external system needs to call Assistant APIs without a signed-in user.

Create a Grafana service account, grant it the Assistant permissions required for the API action, and generate a service account token. Send requests through the Assistant plugin resource path with `Authorization: Bearer` followed by *SERVICE\_ACCOUNT\_TOKEN*.

Service account requests are attributed separately from user requests. Their token usage counts toward the **system-initiated token pool** and any configured limit on it.

Feature-specific APIs, such as Assistant Watchers, use the same plugin resource path and permission model.

### Grafana Assistant HTTP API

The Grafana Assistant HTTP API enables external systems to create conversations, manage Assistant configuration, connect MCP servers, schedule automations, manage Watchers and investigations, and control token limits. Use this when integrating from outside Grafana or automating workflows.

[**Learn more about the HTTP API**](/docs/grafana-cloud/platform/grafana-assistant/reference/http-apis)

### Manage configuration with Terraform

To manage Assistant resources as code, refer to [Manage Grafana Assistant with Terraform](/docs/grafana-cloud/platform/grafana-assistant/configure/terraform).

## Workflows in this hub

Browse the following workflows to choose an integration path and complete common tasks:

- [TypeScript SDK for Grafana plugins](/docs/grafana-cloud/platform/grafana-assistant/reference/typescript-sdk/)  
  Use the @grafana/assistant package to integrate AI assistance into your Grafana plugins and apps.
- [Extend Assistant from an app plugin](/docs/grafana-cloud/platform/grafana-assistant/reference/plugin-extensions/)  
  Register conversation starters, tool details, inline components, and artifact renderers from a Grafana app plugin.
- [Grafana Assistant HTTP API reference](/docs/grafana-cloud/platform/grafana-assistant/reference/http-apis/)  
  Use the Grafana Assistant HTTP API to integrate with external systems and automate workflows.

## Next steps

Continue with these suggestions to explore and integrate:

- Open **Grafana Assistant** from the main navigation and click **Integration hub** for live examples
- Install `@grafana/assistant` from [npm](https://www.npmjs.com/package/@grafana/assistant)
- Review [Grafana plugin development documentation](/docs/grafana/latest/developers/plugins/)