list_runs_in_workspace

Retrieve and filter run history for a specific Terraform Cloud workspace to audit changes, troubleshoot issues, or monitor deployment activity. Supports pagination and detailed filtering by status, operation, source, and more.

Instructions

List runs in a workspace with filtering and pagination

Retrieves run history for a specific workspace with options to filter by status,
operation type, source, and other criteria. Useful for auditing changes, troubleshooting,
or monitoring deployment history.

API endpoint: GET /workspaces/{workspace_id}/runs

Args:
    workspace_id: The workspace ID to list runs for (format: "ws-xxxxxxxx")
    page_number: Page number to fetch (default: 1)
    page_size: Number of results per page (default: 20)
    filter_operation: Filter by operation type
    filter_status: Filter by status
    filter_source: Filter by source
    filter_status_group: Filter by status group
    filter_timeframe: Filter by timeframe
    filter_agent_pool_names: Filter by agent pool names
    search_user: Search by VCS username
    search_commit: Search by commit SHA
    search_basic: Search across run ID, message, commit SHA, and username

Returns:
    List of runs with metadata, status info, and pagination details

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

Input Schema

Name	Required	Description	Default
`filter_agent_pool_names`	No
`filter_operation`	No
`filter_source`	No
`filter_status`	No
`filter_status_group`	No
`filter_timeframe`	No
`page_number`	No
`page_size`	No
`search_basic`	No
`search_commit`	No
`search_user`	No
`workspace_id`	Yes

Input Schema (JSON Schema)

{
  "properties": {
    "filter_agent_pool_names": {
      "default": "",
      "title": "Filter Agent Pool Names",
      "type": "string"
    },
    "filter_operation": {
      "default": "",
      "title": "Filter Operation",
      "type": "string"
    },
    "filter_source": {
      "default": "",
      "title": "Filter Source",
      "type": "string"
    },
    "filter_status": {
      "default": "",
      "title": "Filter Status",
      "type": "string"
    },
    "filter_status_group": {
      "default": "",
      "title": "Filter Status Group",
      "type": "string"
    },
    "filter_timeframe": {
      "default": "",
      "title": "Filter Timeframe",
      "type": "string"
    },
    "page_number": {
      "default": 1,
      "title": "Page Number",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "title": "Page Size",
      "type": "integer"
    },
    "search_basic": {
      "default": "",
      "title": "Search Basic",
      "type": "string"
    },
    "search_commit": {
      "default": "",
      "title": "Search Commit",
      "type": "string"
    },
    "search_user": {
      "default": "",
      "title": "Search User",
      "type": "string"
    },
    "workspace_id": {
      "title": "Workspace Id",
      "type": "string"
    }
  },
  "required": [
    "workspace_id"
  ],
  "title": "list_runs_in_workspaceArguments",
  "type": "object"
}

terraform-cloud-mcp

list_runs_in_workspace

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from terraform-cloud-mcp

Related Tools