---
title: "Get a list of Tasks for the given Deployment Target"
method: GET
path: "/machines/{id}/tasks/v1"
tags: ["DeploymentTargets"]
---

# Get a list of Tasks for the given Deployment Target

`GET /machines/{id}/tasks/v1`

Get a history of related Tasks (ie. Deployments) for a Deployment Target.

## Path parameters

- `id` string, required

## Query parameters

- `skip` integer
- `take` integer
- `type` 'Deployment' | 'RunbookRun'

## Response `200`

The requested list of Tasks for the Deployment Target

- GetTasksForDeploymentTargetResponse
  - `ResourceCollection` TaskResourceCollection, required
    - `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)
