---
title: "Cancel a task"
method: DELETE
path: "/v1/tasks/{id}"
tags: ["Tasks"]
---

# Cancel a task

`DELETE /v1/tasks/{id}`

## Request

- Base URL: `https://api.hotapi.ai`
- URL: `https://api.hotapi.ai/v1/tasks/{id}`
- Auth: HTTP bearer

Cancel a task. Refunds the full charge if it has not started; no refund once the provider has been billed (status=processing). Returns 409 if the task already reached a terminal status.

## Path parameters

- `id` string, required

## Response `200`

Confirmation that a task was cancelled.

- CancelledTask: Confirmation that a task was cancelled.
  - `id` string, required
  - `status` 'cancelled', required

## Other responses

- `400`: Standard error envelope returned by every error response (OpenAI-style).
- `401`: Standard error envelope returned by every error response (OpenAI-style).
- `404`: Standard error envelope returned by every error response (OpenAI-style).
- `409`: Standard error envelope returned by every error response (OpenAI-style).
- `429`: Standard error envelope returned by every error response (OpenAI-style).

---

[API](https://skmtc.dev/hotapi/apis/hotapi-gateway.md) · [All operations](https://skmtc.dev/hotapi/apis/hotapi-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/hotapi/apis/hotapi-gateway/revisions/9b6578b0c389?raw)