API

Access CloudThinker programmatically to manage workspaces, agents, recommendations, and incidents via authenticated HTTPS endpoints

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.

The CloudThinker API exposes the same operations available in the web console as authenticated HTTPS endpoints. Use it to embed cloud operations into your own products, automate workflows, or integrate CloudThinker with internal tooling.

---

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.

curl https://api.cloudthinker.io/v1/workspaces/{workspace_id}/resources \
  -H "Authorization: Bearer $CLOUDTHINKER_API_KEY"

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