Search docs

Search the TryOnCloud API docs

API reference

Delete a result

DELETE /api/v1/results/:id: erase a stored result early.

DELETE https://www.tryoncloud.com/api/v1/results/:id

Permanently deletes one stored result before its automatic 7-day deletion. To download a stored result instead, GET the same URL with your key.

Note: POST /generate stores nothing unless result storage is enabled on your account. Async jobs and batches always keep their result for 7 days, so you can download it. To erase everything for one end user at once, use DELETE /customers/:id.

:id is the X-Result-Id header from the generate response, or result_id on an async job. Use it to honour an end user's request to erase their data.

Request

bash
curl -X DELETE https://www.tryoncloud.com/api/v1/results/RESULT_ID \
  -H "X-API-KEY: $TRYONCLOUD_API_KEY"

Responses

HTTPcodeMeaning
204Deleted. The image and its link no longer work
404NOT_FOUNDNo stored result with that id on your account
401NO_KEY, INVALID_KEYMissing or wrong key
429RATE_LIMITEDOver 120 deletes per minute
500DELETE_FAILEDStorage did not confirm the delete. Retry

Another account's result id returns the same 404, so ids cannot be probed.