Delete an image file or an unsuccessful render

Remove a successful job's file, or remove a failed or cancelled job from history. Repeated requests are safe. The job stays readable by ID, and billing, abuse limits, and idempotency keys stay unchanged. Queued and running jobs return 409.

delete/v1/image/{id}

Request

  • Base URL: https://thirds.ai
  • URL: https://thirds.ai/v1/image/{id}
  • Auth: HTTP bearer

Response

The image job after file or history removal.

referencestring

Your reference, preserved in the job, history, and webhook. Omitted when not supplied.

idstring required
status'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' required
created_atstring date-time required
finished_atstring date-time nullable required
credit'reserved' | 'settled' | 'released' | 'free' | 'none' required

What happened to the credit this job holds: "reserved" while it is queued or running, "settled" once it succeeded, "released" once it failed or was cancelled, "free" when it is the account's free first file and costs no credit, and "none" when the job was never billed.

Changes

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