API Reference

List task runs

get
https://api.render.com/v1/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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

The position in the result list to start from when fetching paginated results. For details, see Pagination.

integer
1 to 100
Defaults to 20

The maximum number of items to return. For details, see Pagination.

taskSlug
array of strings

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.

taskSlug
rootTaskRunId
array of strings

An array of root task run IDs to filter on

rootTaskRunId
ownerId
array of strings

The ID of the workspaces to return resources for

ownerId
workflowVersionId
array of strings

An array of workflow version IDs

workflowVersionId
workflowId
array of strings

An array of workflow IDs

workflowId
Responses

Updated 6 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 months ago