list_runs_in_organization

Retrieve and filter run history across all workspaces in a Terraform organization. Supports auditing, monitoring deployments, and searching by commit, author, or specific attributes with pagination.

Instructions

List runs across all workspaces in an organization

Retrieves run history across all workspaces in an organization with powerful filtering.
Useful for organization-wide auditing, monitoring deployments across teams, or finding
specific runs by commit or author.

API endpoint: GET /organizations/{organization}/runs

Args:
    organization: The organization name
    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
    filter_workspace_names: Filter by workspace names
    search_user: Search by VCS username
    search_commit: Search by commit SHA
    search_basic: Basic search across run attributes

Returns:
    List of runs across workspaces with metadata 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
`filter_workspace_names`	No
`organization`	Yes
`page_number`	No
`page_size`	No
`search_basic`	No
`search_commit`	No
`search_user`	No

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"
    },
    "filter_workspace_names": {
      "default": "",
      "title": "Filter Workspace Names",
      "type": "string"
    },
    "organization": {
      "title": "Organization",
      "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"
    }
  },
  "required": [
    "organization"
  ],
  "title": "list_runs_in_organizationArguments",
  "type": "object"
}

terraform-cloud-mcp

list_runs_in_organization

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from terraform-cloud-mcp

Related Tools