list_state_versions

Retrieve and filter paginated state versions in a Terraform Cloud workspace by organization, workspace name, and status. Useful for tracking and managing infrastructure changes.

Instructions

List state versions in a workspace.

Retrieves a paginated list of all state versions in a Terraform Cloud workspace. Results can be filtered using status to find specific state versions.

API endpoint: GET /state-versions

Args: organization: The name of the organization that owns the workspace workspace_name: The name of the workspace to list state versions from page_number: The page number to return (default: 1) page_size: The number of items per page (default: 20, max: 100) filter_status: Filter state versions by status: 'pending', 'finalized', or 'discarded'

Returns: Paginated list of state versions with their configuration settings and metadata

See: docs/tools/state_versions.md for reference documentation

Input Schema

Name	Required	Description	Default
`filter_status`	No
`organization`	Yes
`page_number`	No
`page_size`	No
`workspace_name`	Yes

Input Schema (JSON Schema)

{
  "properties": {
    "filter_status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Filter Status"
    },
    "organization": {
      "title": "Organization",
      "type": "string"
    },
    "page_number": {
      "default": 1,
      "title": "Page Number",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "title": "Page Size",
      "type": "integer"
    },
    "workspace_name": {
      "title": "Workspace Name",
      "type": "string"
    }
  },
  "required": [
    "organization",
    "workspace_name"
  ],
  "type": "object"
}

terraform-cloud-mcp