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
| Capability | Description |
|---|---|
| Trigger Conversations | Start agent conversations programmatically with @agent #tool prompts and stream responses back to your app |
| Query 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