---
title: "Creates a new task and executes it, using a given task as the input. Note that deployment tasks cannot be re-run."
method: POST
path: "/tasks/rerun/{id}"
tags: ["Tasks"]
---

# Creates a new task and executes it, using a given task as the input. Note that deployment tasks cannot be re-run.

`POST /tasks/rerun/{id}`

## Path parameters

- `id` string, required

## Response `200`

Carries the new task created in response to re-running an existing task via RerunServerTaskCommand.

- 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'

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