# Eliminar um resultado

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

Elimina definitivamente um resultado guardado antes da sua eliminação automática ao fim de 7 dias. Para descarregar um resultado guardado, faça um `GET` ao mesmo URL com a sua chave.

> **Nota:** `POST /generate` não guarda nada, exceto se o armazenamento de resultados estiver ativado na sua conta. As tarefas assíncronas e os lotes guardam sempre o resultado durante 7 dias para que o possa descarregar. Para apagar de uma só vez tudo o que diz respeito a um utilizador final, utilize [`DELETE /customers/:id`](/docs/async#delete-a-customers-data).

`:id` é o cabeçalho `X-Result-Id` da resposta de [geração](/docs/generate), ou o campo `result_id` de uma [tarefa assíncrona](/docs/async). Utilize-o para dar seguimento ao pedido de um utilizador final para apagar os seus dados.

## Pedido

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

## Respostas

| HTTP | código | Significado |
|---|---|---|
| 204 |  | Eliminado. A imagem e o respetivo link já não funcionam |
| 404 | `NOT_FOUND` | Não existe nenhum resultado guardado com esse ID na sua conta |
| 401 | `NO_KEY`, `INVALID_KEY` | Chave em falta ou errada |
| 429 | `RATE_LIMITED` | Mais de 120 eliminações por minuto |
| 500 | `DELETE_FAILED` | O sistema de armazenamento não confirmou a eliminação. Tentar novamente |

O ID do resultado de outra conta devolve o mesmo código `404`, pelo que não é possível verificar os IDs.
