List task runs
render_list_task_runsRead-onlyIdempotent
Retrieve task runs with optional filters for workflow, owner, or version to find specific execution history.
Instructions
List task runs. List task runs that match the provided filters. If no filters are provided, all task runs accessible by the authenticated user are returned. Calls GET /task-runs on the Render Public API.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | The maximum number of items to return. For details, see [Pagination](https://api-docs.render.com/reference/pagination). | |
| cursor | No | The position in the result list to start from when fetching paginated results. For details, see [Pagination](https://api-docs.render.com/reference/pagination). | |
| ownerId | No | The ID of the workspaces to return resources for | |
| taskSlug | No | An array of task slugs in the format workflow-slug/task-name. An optional version can be appended (workflow-slug/task-name:version). If no version is provided, the latest version is used. | |
| workflowId | No | An array of workflow IDs | |
| rootTaskRunId | No | An array of root task run IDs to filter on | |
| workflowVersionId | No | An array of workflow version IDs |