---
title: "Marks the given task as canceled."
method: POST
path: "/{spaceId}/tasks/{id}/cancel"
tags: ["Tasks"]
---

# Marks the given task as canceled.

`POST /{spaceId}/tasks/{id}/cancel`

## Path parameters

- `spaceId` string, required
- `id` string, required

## Response `200`

Returned in response to CancelServerTaskRequest. If the ServerTask cancellation failed, clients should receive an error instead.

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