> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# API

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

<Note>
  **Preview** — The CloudThinker REST API is in early access. Endpoints, payloads, and authentication flows may change before general availability. [Contact us](https://cloudthinker.io/contact) to join the preview.
</Note>

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.

```bash theme={null}
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](/guide/connections/overview) |

***

## 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

<CardGroup cols={2}>
  <Card title="MCP Server" icon="plug" href="/guide/mcp/overview">
    Use CloudThinker tools from MCP-compatible AI clients
  </Card>

  <Card title="CLI" icon="terminal" href="/guide/cli/overview">
    Run CloudThinker operations from your terminal
  </Card>

  <Card title="Webhooks" icon="webhook" href="/guide/webhooks/overview">
    Receive event-driven notifications instead of polling
  </Card>

  <Card title="Connections" icon="link" href="/guide/connections/overview">
    Connect cloud providers and SaaS systems
  </Card>
</CardGroup>