Tasks

Delete a task's result

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.

delete/v1/tasks/{id}/result

Request

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

Path parameters

idstring required

Response

Outcome of deleting one task's result assets.

idstring required
object'task_result' required
deletedboolean 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_deletedboolean required

True when there was nothing left to clear: a prior deletion, or a task that never produced assets (failed/cancelled).

assets_deletedinteger required

R2 objects this call removed.

assets_unreachableinteger 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_linksinteger 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_atinteger nullable required

Unix seconds the deletion was recorded, when applicable.

statusstring required

deleted | already_deleted | no_result

Example response

{
  "id": "task_8sd9f7aQ2",
  "status": "deleted"
}

Changes

No recorded changes to this operation across all 1 revision of this API.