Developer tools
Grafana Cloud in your product and your AI agents, through one API
The Grafana Cloud toolkit covers the dashboards and folders of a stack: read them, create them from JSON and update them. Your customer connects once with an API key, and your product or AI agent calls each operation through Connect, which stores the credential and logs every execution.
15 days to try it. No credit card.
POST https://connect.reportei.com/api/tools/grafana_create_dashboard/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"namespace": "<namespace>",
"metadata": {},
"spec": {}
}
}How it works
From a connected customer to the first Grafana Cloud call.
- 1
Your customer connects the account
Your system opens a Connect session for the toolkit and your customer connects their Grafana Cloud account. You get the connection id.
- 2
Your product calls the tool
A POST to /api/tools/{tool}/execute with the connection id and arguments. On success, Connect preserves the app's response status and body.
- 3
Connect handles the rest
It stores the credential encrypted, renews tokens for OAuth connections that support renewal and records executions in an audit trail available through the API.
Use cases
What your product does with Grafana Cloud.
Provision dashboards for customers
When a customer is onboarded, create a folder and a dashboard from a JSON template in their stack, so monitoring is ready on day one.
Keep dashboards in sync
Read a dashboard, change its spec and send it back with the resourceVersion, so your product can push panel or variable updates safely.
Dashboard discovery for agents
Let an AI agent list folders and dashboards, read a dashboard's panels and time range, and describe what a stack already monitors.
Tools
7 Grafana Cloud tools
- List dashboardsGETLists the dashboards of the stack. Each item has metadata.name, the uid the other tools ask for, the folder uid in the metadata annotation grafana.app/folder and the whole dashboard JSON in spec, with its title. Keep limit small; when metadata.continue comes back, pass it as continue for the next page.
- Get dashboardGETReturns one dashboard: metadata, with the uid in name, the resourceVersion and the folder annotation, and the dashboard JSON in spec, with title, panels, variables and time range.
- Create dashboardPOSTCreates a dashboard from its JSON in spec, at the root or in a folder. Send metadata.name with the uid you want, or metadata.generateName with a prefix for a random uid. A uid already in use answers 409.
- Update dashboardPUTReplaces a dashboard with a new version of its JSON. Read it with Get dashboard first, change spec and send back the whole spec, because fields left out are removed. Send the resourceVersion you read so a newer change is not overwritten; a stale one answers 409.
- List foldersGETLists the folders of the stack the token can see, each with metadata.name, the uid the folder fields of the other tools ask for, the parent folder in the metadata annotation grafana.app/folder and the title in spec. When metadata.continue comes back, pass it as continue for the next page.
- Create folderPOSTCreates a folder at the root or inside another folder. Send metadata.name with the uid you want, or metadata.generateName with a prefix for a random uid.
- Update folderPUTRenames a folder or moves it under another one. Send the title, and the parent in the annotation grafana.app/folder when it has one, because the call replaces the folder.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
When connecting, your customer also enters {stack}: the address of their account on the app's API.
Questions about the Grafana Cloud toolkit
Do I need to build against the Grafana Cloud API?
No. Connect ships 7 Grafana Cloud tools, described and ready. Your customer connects the account and your system calls every tool through the same endpoint, with the same request format.
How does my customer connect their Grafana Cloud account?
With the mode the toolkit accepts: API key. Connect stores the credential encrypted and never returns it to your system.
Does it work with AI agents?
Yes. Each tool's input is described in JSON Schema, which your agent uses directly as a tool definition. The agent picks the tool and the arguments, and your system makes the call to Connect.
Does my customer need a Reportei account?
No. Your customer connects the account on a Connect screen, or your system sends the credential through the API, and they keep using only your product.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
