get_run_details
Retrieve comprehensive details about a specific Terraform Cloud run, including status, plan output, and resource relationships to monitor progress and analyze results.
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 main handler function that fetches detailed information about a specific Terraform Cloud run using the API endpoint /runs/{run_id}. It takes a run_id parameter and returns an APIResponse.@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)The registration of the get_run_details tool in the MCP server using the FastMCP tool decorator.mcp.tool()(runs.get_run_details)