Clone a workspace with its variables (operator; an auto-applying source needs admin)

Changed on
post/workspaces/{workspaceId}/clone

Request

  • Base URL: /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/workspaces/{workspaceId}/clone
  • Auth: HTTP bearer

Path parameters

workspaceIdstring required

Request body

namestring required
descriptionstring
environmentstring
requires_approvalboolean

Approval gate for the clone. Omit to inherit the source's. Raising it is an operator action — it is how a clone of a config another workspace already gates gets created without an admin. Clearing a gate the source holds needs admin.

Response

Cloned workspace

idstring required
org_idstring required
namestring required
descriptionstring
source'vcs' | 'upload' required
repo_urlstring required
repo_branchstring required
working_dirstring required
tofu_versionstring required
environment'development' | 'staging' | 'production' required
auto_applyboolean required
requires_approvalboolean required
vcs_trigger_enabledboolean required
lockedboolean required
locked_bystring nullable
current_run_idstring nullable
current_config_version_idstring
created_bystring required
created_atstring date-time required
updated_atstring date-time required
last_run_statusstring nullable

List-view rollup.

last_run_atstring date-time nullable

List-view rollup.

resource_countinteger

List-view rollup.

effective_role'viewer' | 'operator' | 'admin' | 'owner'

The caller's role on this workspace: their org role, or a higher role one of their teams holds through a workspace team grant. Single-workspace reads only.

Changes