SCscalr
runs

List Runs

Changed on

This endpoint lists runs for a specific workspace.

get/runs

Request

  • Base URL
    https://example.scalr.io/api/iacp/v3
  • URL
    https://example.scalr.io/api/iacp/v3/runs
  • Auth
    HTTP bearer

Query parameters

page[number]string

Page number

page[size]string

Page size

includestring[]

The comma-separated list of relationship paths.

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[actor]string

Filter runs by who created them, e.g. in:ai-agent,service-account.

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.

querystring

Query string

filter[is-dry]string

The is dry runs filter.

scheduledstring

List only runs that are scheduled.

filter[tag]string

Filter runs by tags.

filter[resource-drifts]string

Filter the runs by drifted resources count.

appliesstring

The comma-separated list of fields to return in response for Apply resource.

configuration-versionsstring

The comma-separated list of fields to return in response for ConfigurationVersion resource.

cost-estimatesstring

The comma-separated list of fields to return in response for CostEstimate resource.

environmentsstring

The comma-separated list of fields to return in response for Environment resource.

plansstring

The comma-separated list of fields to return in response for Plan resource.

policy-checksstring

The comma-separated list of fields to return in response for PolicyCheck resource.

runsstring

The comma-separated list of fields to return in response for Run resource.

status-transitionsstring

The comma-separated list of fields to return in response for StatusTransition resource.

tagsstring

The comma-separated list of fields to return in response for Tag resource.

usersstring

The comma-separated list of fields to return in response for User resource.

vcs-revisionsstring

The comma-separated list of fields to return in response for VcsRevision resource.

workspacesstring

The comma-separated list of fields to return in response for Workspace resource.

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.

Response

Success.

includedobject[]
linksobject
metaobject

Changes

  • d3e1dc85657aRevision changes
    • warning

      added the new mcp enum value to the /////// response property for the response status

    • info

      added the new optional query request parameter filter[actor]

    • info

      added the optional property /// to the response with the status