list_runs_in_workspace
Retrieve and filter run history for a specific workspace to audit changes, troubleshoot, or monitor deployment activity with paginated results.
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.md for reference documentation
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 |