get_run_details
Retrieve comprehensive details about a specific Terraform Cloud run, including status, plan output, and resource relationships. Use to monitor progress or analyze results via the provided run ID.
Instructions
Get detailed information about a specific run
Retrieves comprehensive information about a run including its current status, plan output, and relationship to other resources. Use to check run progress or results.
API endpoint: GET /runs/{run_id}
Args: run_id: The ID of the run to retrieve details for (format: "run-xxxxxxxx")
Returns: Complete run details including status, plan, and relationships
See: docs/tools/run.md for reference documentation
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | Yes |
Implementation Reference
- The handler function that executes the tool logic: fetches detailed information about a specific Terraform Cloud run by ID via the API.@handle_api_errors async def get_run_details(run_id: str) -> APIResponse: """Get detailed information about a specific run Retrieves comprehensive information about a run including its current status, plan output, and relationship to other resources. Use to check run progress or results. API endpoint: GET /runs/{run_id} Args: run_id: The ID of the run to retrieve details for (format: "run-xxxxxxxx") Returns: Complete run details including status, plan, and relationships See: docs/tools/run.md for reference documentation """ # Make API request return await api_request(f"runs/{run_id}", method="GET")
- terraform_cloud_mcp/server.py:67-67 (registration)Registers the get_run_details function as an MCP tool using FastMCP's tool decorator.mcp.tool()(runs.get_run_details)