HTTP APIs¶

Note

These APIs are available with the Robusta SaaS platform and self-hosted commercial plans. They are not available in the open-source version.

The Robusta Platform exposes REST APIs for programmatic access to alerts, investigations, and platform data. Every request is authenticated with an API key, scoped to one or more of the permissions below.

Robusta AI¶

Holmes Chat API: Send questions to HolmesGPT for on-demand root cause analysis via REST, including a streaming (SSE) mode
Platform MCP API: Connect an external MCP client (Claude Code, Claude Desktop, or your own agent) to run Robusta's cross-cluster investigation tools
LLM Models API: List the Robusta-hosted LLM models available to your account and its default model

Data Export and Reporting¶

Alert Export API: Export historical alert data with filtering by time range, alert name, and account
Alert Reporting API: Get aggregated statistics and counts for different alert types
Send Events API: Send alerts, incidents, and changes from any monitoring source via a single webhook endpoint

RBAC¶

RBAC Configuration API: Programmatically manage role-based access control configurations

API Key Permissions¶

Every API key is scoped by a set of resource/action pairs, chosen when the key is created under Settings → API Keys → New API Key. The table below lists every permission and the HTTP APIs it unlocks.

Resource	Action	Grants access to	Docs
Alerts	Read	Export alert history and aggregated alert statistics	Alert Export API, Alert Reporting API
Alerts	Write	Ingest alerts, incidents, and config changes into Robusta	Send Events API, Send Alerts API (legacy), Configuration Changes API (legacy)
Robusta AI	Write	Ask HolmesGPT to investigate, run MCP tools against your clusters, and list available LLM models	Holmes Chat API, Platform MCP API, LLM Models API
RBAC	Read / Write	Read or replace the account's role-based access control configuration	RBAC Configuration API
Agents	Read	Read active Kubernetes resource counts for a namespace, as shown in the UI's Namespaces tab	Namespace Resources API (Robusta Classic)
KRR	Read	Retrieve KRR resource-sizing recommendations for a cluster	KRR API (Robusta Classic)
Metrics	Read	Run a PromQL query against a connected cluster's Prometheus	Prometheus Query API (Robusta Classic)

Getting Started¶

To access these APIs:

Sign up for Robusta SaaS or contact support@robusta.dev for self-hosted plans
Generate API keys in the Robusta Platform under Settings → API Keys