List Runs

get

https://{Domain}/api/iacp/v3/runs

This endpoint lists runs for a specific workspace.

Query Params

page[number]

string

Page number

page[size]

string

Page size

include

array of strings

The comma-separated list of relationship paths.

include

filter[workspace]

string

The workspace ID to list runs for.

filter[account]

string

The account ID to list runs for.

filter[environment]

string

The environment ID to list runs for.

filter[run]

string

The comma-separated list of run IDs.

filter[status]

string

The run status filter.

filter[source]

string

The run source filter.

filter[vcs-revision]

string

Commit sha that affected runs

filter[created-by]

string

The ID of the User who triggered this run

filter[created-by-run]

string

The ID of the Run which triggered this run

filter[env-or-ws]

string

The list of environment or workspaces IDs to match

filter[created-at]

string

The run created at filter.

query

string

Query string

filter[is-dry]

string

The is dry runs filter.

scheduled

string

List only runs that are scheduled.

filter[tag]

string

Filter runs by tags.

filter[resource-drifts]

string

Filter the runs by drifted resources count.

fields

object

The value of the fields[resource-type] parameter is a comma-separated list that refers to the name of the fields to be returned for the resource. An empty value indicates that no fields should be returned.

Responses

404

Workspace not found, or user unauthorized to perform action.

4XX

Client error.

5XX

Server error.

Language

Credentials

Bearer

URL

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/vnd.api+json

200Success.