---
title: "Delete a task's result"
method: DELETE
path: "/v1/tasks/{id}/result"
tags: ["Tasks"]
---

# Delete a task's result

`DELETE /v1/tasks/{id}/result`

## Request

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

Delete the generated files for a task and clear their URLs, before the 7-day retention deadline. The task record itself is kept (billing history and status), and deleting a result does not change what you were charged. Idempotent: a second call reports `already_deleted`. Tasks still running return 409; cancel them instead. Assets the model provider hosts on its own storage cannot be deleted by us and are reported in `assets_unreachable`.

## Path parameters

- `id` string, required

## Response `200`

Outcome of deleting one task's result assets.

- DeletedTaskResult: Outcome of deleting one task's result assets.
  - `id` string, required
  - `object` 'task_result', required
  - `deleted` boolean, required: True when this call cleared the result: the asset URLs are gone from your task. `assets_deleted` says how many objects we removed for you.
  - `already_deleted` boolean, required: True when there was nothing left to clear: a prior deletion, or a task that never produced assets (failed/cancelled).
  - `assets_deleted` integer, required: R2 objects this call removed.
  - `assets_unreachable` integer, required: Assets hosted by the model provider that we cannot delete. Their URLs are cleared here; the provider's own copy is governed by its policy.
  - `cdn_purged_links` integer, required: Links invalidated at the CDN edge. When this is lower than `assets_deleted`, the remaining links stop working only when their cache entry expires (up to 4 hours).
  - `deleted_at` integer, nullable, required: Unix seconds the deletion was recorded, when applicable.
  - `status` string, required: deleted | already_deleted | no_result

## 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).
- `503`: 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)