---
title: "Returns a list of runbook dashboard items, filtered by various criteria including projectIds, environmentIds, tenantIds, tenantTags, runbookIds, runbookTags, taskIds"
method: GET
path: "/progression/runbooks/taskRuns"
tags: ["Progression"]
---

# Returns a list of runbook dashboard items, filtered by various criteria including projectIds, environmentIds, tenantIds, tenantTags, runbookIds, runbookTags, taskIds

`GET /progression/runbooks/taskRuns`

## Query parameters

- `environmentIds` string[]
- `projectIds` string[]
- `runbookIds` string[]
- `runbookTags` string[]
- `skip` integer
- `take` integer
- `taskIds` string[]
- `tenantIds` string[]
- `tenantTags` string[]

## Response `200`

The list of runbook dashboard items

- RunbooksDashboardItemResourceCollection
  - `Id` string
  - `Items` RunbooksDashboardItemResource[]
    - `CompletedTime` string, date-time
    - `Created` string, date-time
    - `Duration` string
    - `EnvironmentId` string
    - `ErrorMessage` string
    - `GitReference` RunbooksDashboardItemResourceGitReference
      - `GitCommit` string
      - `GitRef` string
    - `HasPendingInterruptions` boolean
    - `HasPendingPreconditions` boolean
    - `HasWarningsOrErrors` boolean
    - `Id` string
    - `IsCompleted` boolean
    - `LastModifiedBy` string
    - `LastModifiedOn` string, date-time
    - `Links` object
    - `PendingInterruptionTypes` string[]
    - `PendingPreconditionTypes` string[]
    - `ProjectId` string
    - `QueueTime` string, date-time
    - `RunbookId` string
    - `RunbookSnapshotId` string
    - `RunbookSnapshotName` string
    - `RunbookSnapshotNotes` string
    - `RunBy` string
    - `RunName` string
    - `StartTime` string, date-time
    - `State` 'Queued' | 'Executing' | 'Failed' | 'Canceled' | 'TimedOut' | 'Success' | 'Cancelling'
    - `TaskId` string
    - `TenantId` string
  - `ItemsPerPage` integer
  - `ItemType` string
  - `LastModifiedBy` string
  - `LastModifiedOn` string, date-time
  - `LastPageNumber` integer
  - `Links` object
  - `NumberOfPages` integer
  - `TotalResults` integer

## Other responses

- `304` — Not Modified
- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

[API](https://skmtc.net/octopus/apis/octopus-server-api.md) · [All operations](https://skmtc.net/octopus/apis/octopus-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octopus/octopus-server-api/versions/bc9158facfc7/schema)