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
| HTTP | code | Meaning |
|---|---|---|
| 204 | Deleted. The image and its link no longer work | |
| 404 | NOT_FOUND | No stored result with that id on your account |
| 401 | NO_KEY, INVALID_KEY | Missing or wrong key |
| 429 | RATE_LIMITED | Over 120 deletes per minute |
| 500 | DELETE_FAILED | Storage did not confirm the delete. Retry |
Another account's result id returns the same 404, so ids cannot be probed.