# Harness Workspaces API

**Canonical:** https://apis.io/apis/harness/harness-workspaces-api/  
**Provider:** Harness — https://apis.io/providers/harness/  
**Base URL:** https://app.harness.io  
**Documentation:** https://apidocs.harness.io

Harness Workspaces API is one of 488 APIs that [Harness](https://apis.io/providers/harness/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Workspace. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

Workspaces Service handles the API for managing workspaces and triggering workflows against them.

## Operations (41)

| Method | Path | Summary |
|---|---|---|
| GET | `/iacm/api/orgs/{org}/projects/{project}/tags` | List all workspace tags |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspace-metrics` | Show workspace metrics |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces` | List workspaces |
| POST | `/iacm/api/orgs/{org}/projects/{project}/workspaces` | Create workspace |
| DELETE | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{identifier}` | Destroy workspace |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{identifier}` | Show workspace |
| PUT | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{identifier}` | Update workspace |
| POST | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{identifier}/actions/force-unlock` | Unlock workspace |
| POST | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{identifier}/actions/lock` | Lock workspace |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{identifier}/modules` | List modules |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{identifier}/resources` | List resources |
| POST | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{identifier}/resources/search` | List resources using selectors |
| POST | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/clone` | Clone workspace |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/data` | List data |
| POST | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/data` | Create data |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/data/{id}` | Show data |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/data/{id}/evaluate-policy` | Evaluate data |
| POST | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/dependency-graph` | Upload dependency graph data |
| DELETE | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/drift-config` | Disable drift automation for a workspace |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/drift-config` | Get drift automation status for a workspace |
| PUT | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/drift-config` | Enable drift automation for a workspace |
| DELETE | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/ephemeral-config` | Disable ephemeral TTL for a workspace |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/ephemeral-config` | Get ephemeral TTL status for a workspace |
| PUT | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/ephemeral-config` | Enable ephemeral TTL for a workspace |
| POST | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/events` | Send event |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/pipelines` | List pipelines |
| POST | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/remote-executions` | Create remote execution |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/remote-executions/{id}` | Show remote execution |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/remote-executions/{id}/download` | Download remote execution |
| POST | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/remote-executions/{id}/execute` | execute-remote-execution workspaces |
| POST | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/remote-executions/{id}/upload` | Upload remote execution source |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/resource-types` | List workspace resource types |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/resource-types-and-attributes` | Map of resource types and their attributes |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/resource-types/{resource_type}/attributes` | List workspace resource type attributes |
| DELETE | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/resources` | Delete resources |
| PATCH | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/resources` | Update resources |
| DELETE | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/resources/stale` | Delete stale resources |
| POST | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/risk-assessment` | Upload risk assessment data |
| POST | `/iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/state-versions/{data_id}/rollback` | Roll back workspace state to a previous version |
| GET | `/iacm/api/orgs/{org}/projects/{project}/workspaces/provisioners-ratio` | List provisioners ratio |
| GET | `/iacm/api/workspace/templates/{template_id}` | List workspaces associated with a template ID |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/openapi/harness-workspaces-api-openapi.yml
- **Documentation** — https://apidocs.harness.io
- **APIReference** — https://apidocs.harness.io
- **GettingStarted** — https://developer.harness.io/docs/platform/automation/api/api-quickstart/
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/authentication/harness-authentication.yml
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/scopes/harness-scopes.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/errors/harness-error-codes.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/conventions/harness-conventions.yml
- **Idempotency** — https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/conventions/harness-conventions.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/rate-limits/harness-rate-limits.yml

## Other Harness APIs (12)

- [Harness Continuous Integration API](https://apis.io/apis/harness/ci-api/)
- [Harness Continuous Delivery and GitOps API](https://apis.io/apis/harness/cd-api/)
- [Harness Feature Management and Experimentation API](https://apis.io/apis/harness/feature-flags-api/)
- [Harness Cloud Cost Management API](https://apis.io/apis/harness/ccm-api/)
- [Harness Chaos Engineering API](https://apis.io/apis/harness/chaos-api/)
- [Harness Security Testing Orchestration API](https://apis.io/apis/harness/sto-api/)
- [Harness Internal Developer Portal API](https://apis.io/apis/harness/idp-api/)
- [Harness Code Repository API](https://apis.io/apis/harness/code-repo-api/)
- [Harness Service Reliability Management API](https://apis.io/apis/harness/srm-api/)
- [Harness Infrastructure as Code Management API](https://apis.io/apis/harness/iacm-api/)
- [Harness Supply Chain Security API](https://apis.io/apis/harness/ssca-api/)
- [Harness Software Engineering Insights API](https://apis.io/apis/harness/sei-api/)

## Tags

Workspace

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/harness/harness-workspaces-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/harness/.