force_unlock_workspace
Force unlock a Terraform Cloud workspace when normal unlocking fails or is unavailable. Requires admin privileges. Use with caution 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.md for reference documentation
Input Schema
Name | Required | Description | Default |
---|---|---|---|
workspace_id | Yes |