force_unlock_workspace

Force unlock a Terraform Cloud workspace when normal unlocking fails, such as due to orphaned locks or unavailable users. Requires admin privileges and careful use to avoid disrupting active operations.

Instructions

Force unlock a workspace. This should be used with caution.

Forces a workspace to unlock even when the normal unlock process isn't possible.
This is typically needed when a run has orphaned a lock or when the user who locked
the workspace is unavailable. This operation requires admin privileges on the workspace.

WARNING: Forcing an unlock can be dangerous if the workspace is legitimately locked
for active operations. Only use this when you are certain it's safe to unlock.

API endpoint: POST /workspaces/{workspace_id}/actions/force-unlock

Args:
    workspace_id: The ID of the workspace to force unlock (format: "ws-xxxxxxxx")

Returns:
    The workspace with updated lock status and related metadata

See:
    docs/tools/workspace_tools.md for usage examples

Input Schema

Name	Required	Description	Default
`workspace_id`	Yes

Input Schema (JSON Schema)

{
  "properties": {
    "workspace_id": {
      "title": "Workspace Id",
      "type": "string"
    }
  },
  "required": [
    "workspace_id"
  ],
  "title": "force_unlock_workspaceArguments",
  "type": "object"
}

terraform-cloud-mcp

force_unlock_workspace

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from terraform-cloud-mcp

Related Tools