Preview — The CloudThinker REST API is in early access. Endpoints, payloads, and authentication flows may change before general availability. Contact us to join the preview.
What You Can Do
Trigger Conversations
Start agent conversations programmatically with
@agent #tool prompts and stream responses back to your appQuery Resources
Fetch the unified inventory of cloud resources, costs, and topology across AWS, GCP, and Azure
Manage Recommendations
List, accept, dismiss, or comment on cost, security, and reliability recommendations
Drive Incidents
Create incidents, attach signals, request RCA, and read investigation results
Authentication
The API uses workspace-scoped API keys passed via a bearer token header.| Field | Description |
|---|---|
| Scope | Each key is bound to a single workspace |
| Permissions | Inherits the role of the issuing member |
| Rotation | Keys can be revoked at any time from workspace settings |
Endpoint Surface
| Resource | Purpose |
|---|---|
/v1/workspaces | Workspace metadata and members |
/v1/conversations | Start, list, and resume agent conversations |
/v1/resources | Discovered cloud resource inventory |
/v1/recommendations | Cost, security, and reliability recommendations |
/v1/incidents | Incident lifecycle and RCA results |
/v1/dashboards | Built-in and custom dashboard data |
/v1/skills | Workspace skills and execution |
/v1/connections | Cloud and SaaS connections |
Versioning
The API is versioned in the URL path (/v1/). Breaking changes ship under a new version; additive changes ship in place. Deprecated versions remain available for at least 12 months after a successor is released.
Related
MCP Server
Use CloudThinker tools from MCP-compatible AI clients
CLI
Run CloudThinker operations from your terminal
Webhooks
Receive event-driven notifications instead of polling
Connections
Connect cloud providers and SaaS systems