---
title: "Lists all of the tasks in the supplied Octopus Deploy Space. The results will be sorted from newest to oldest."
method: GET
path: "/tasks"
tags: ["Tasks"]
---

# Lists all of the tasks in the supplied Octopus Deploy Space. The results will be sorted from newest to oldest.

`GET /tasks`

## Query parameters

- `active` boolean
- `batch` string
- `description` string
- `environment` string
- `fromCompletedDate` string, date-time
- `fromQueueDate` string, date-time
- `fromStartDate` string, date-time
- `hasPendingInterruptions` boolean
- `hasPendingPreconditions` boolean
- `hasWarningsOrErrors` boolean
- `ids` string[]
- `name` string[]
- `node` string
- `partialName` string
- `project` string
- `runbook` string
- `running` boolean
- `skip` integer
- `states` string[]
- `take` integer
- `tenant` string
- `tenantTag` string
- `toCompletedDate` string, date-time
- `toQueueDate` string, date-time
- `toStartDate` string, date-time

## Response `200`

Holds a TaskResourceCollection generated in response to a ListServerTasksRequest

- TaskResourceCollection
  - `Id` string
  - `Items` TaskResource[]
    - `Arguments` object
    - `CanRerun` boolean
    - `Completed` string
    - `CompletedTime` string, date-time
    - `Description` string
    - `Duration` string
    - `ErrorMessage` string
    - `EstimatedRemainingQueueDurationSeconds` integer
    - `FinishedSuccessfully` boolean
    - `HasBeenPickedUpByProcessor` boolean
    - `HasPendingInterruptions` boolean
    - `HasPendingPreconditions` boolean
    - `HasWarningsOrErrors` boolean
    - `Id` string
    - `IsCompleted` boolean
    - `LastModifiedBy` string
    - `LastModifiedOn` string, date-time
    - `LastUpdatedTime` string, date-time
    - `Links` object
    - `Name` string
    - `PendingInterruptionTypes` string[]
    - `PendingPreconditionTypes` string[]
    - `ProjectId` string
    - `QueueTime` string, date-time
    - `QueueTimeExpiry` string, date-time
    - `ServerNode` string
    - `SpaceId` string
    - `StartTime` string, date-time
    - `State` 'Queued' | 'Executing' | 'Failed' | 'Canceled' | 'TimedOut' | 'Success' | 'Cancelling'
  - `ItemsPerPage` integer
  - `ItemType` string
  - `LastModifiedBy` string
  - `LastModifiedOn` string, date-time
  - `LastPageNumber` integer
  - `Links` object
  - `NumberOfPages` integer
  - `TotalResults` integer

## Other responses

- `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)