---
title: 'Terraform Cloud'
description: 'Manage infrastructure as code with Terraform Cloud workspaces, runs, and state.'
---

# Terraform Cloud

Manage infrastructure as code with Terraform Cloud workspaces, runs, and state.

| Detail | Value |
|---|---|
| Category | DevOps |
| Base URL | `https://app.terraform.io/api/v2` |
| Authentication | Bearer Token |
| Endpoints | 8 |
| Connector key | `terraform-cloud` |

## Using Terraform Cloud in a workflow

1. Go to **Connections** and click **New Connection**.
2. Pick **Terraform Cloud** from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an **API Call** node and select this connection.
5. Pick the operation you need from the Operation dropdown — see the table below.

## Available Endpoints

| Endpoint | Summary |
|---|---|
| [GET /organizations](./get_organizations_devops_listorganizations) | List organizations |
| [GET /organizations/{organization_name}/workspaces](./get_organizations_organization_name_workspaces_devops_listworkspaces) | List workspaces |
| [POST /organizations/{organization_name}/workspaces](./post_organizations_organization_name_workspaces_devops_createworkspace) | Create a workspace |
| [GET /workspaces/{workspace_id}](./get_workspaces_workspace_id_devops_getworkspace) | Get workspace details |
| [POST /runs](./post_runs_devops_createrun) | Create a run |
| [GET /runs/{run_id}](./get_runs_run_id_devops_getrun) | Get run details |
| [POST /runs/{run_id}/actions/apply](./post_runs_run_id_actions_apply_devops_applyrun) | Apply a run |
| [GET /workspaces/{workspace_id}/current-state-version](./get_workspaces_workspace_id_current_state_version_devops_getcurrentstateversion) | Get current state |

> Each endpoint has its own page with parameter details, an example
> `API Call` node configuration, and the response shape.