Actions16
- Workspace Actions
- Run Actions
- Project Actions
- GitHub App Installation Actions
Run → List by Workspace
AI-generatedSummary
List runs associated with a specific Terraform Cloud workspace, supporting pagination through optional page number and page size parameters.
Inputs
- Workspace ID (required) — The unique identifier of the workspace whose runs you want to list. This must be the ID as required by the Terraform Cloud API, not the workspace name.
- Options — Optional parameters to control pagination of the runs list. Includes 'Page Number' (the page of results to return, minimum 1) and 'Page Size' (the number of results per page, between 1 and 100).
Output shape
A JSON object containing the list of runs for the specified workspace, which includes run details as returned by the Terraform Cloud API.
The results are paginated according to the 'Page Number' and 'Page Size' options if specified. The output is an object which reflects the API's runs listing response under the workspace endpoint.
Examples
Example 1: Listing first 20 runs for a workspace
Provide the workspace ID, leave default pagination options (page 1 and 20 results per page) or set different pagination as needed.