<!-- https://developers.silktide.com/v1/governance/reports/delete-report | Governance / Reports -->

# Delete a report

`DELETE /v1/reports/{reportId}`

Deletes a report and its results at once. It cannot be undone.

The response is an empty `201`. Deleting it again returns `404`.

Deleting a snapshot a [report schedule](https://developers.silktide.com/v1/governance/report-schedules.md) made leaves the schedule as it is, and it goes on making new ones.

## Request

### Path parameters

- `reportId` (integer, required, at least 1): The report.

## Response

Status `201`.
 No body.

## Errors

| Status | Type | When |
| --- | --- | --- |
| 403 | `EditionNotAvailable` | The account does not have Silktide 4. Reports, report schedules and report templates are Silktide 4's, so an account with only Silktide 5 cannot use them. |
| 400 | `InvalidRequest` | `reportId` is not a whole number. `properties.field` is `reportId`. |
| 404 | `ModelNotFound` | No report with that id exists in the account. |
| 403 | `AccessDenied` | The API key's user cannot see or admin the report. |
| 401 | `NotLoggedIn` | No API key was sent, or it is not a key for this region. |
| 429 | `TooManyRequests` | Too many requests to this path in five seconds. Retry after the number of seconds in the `Retry-After` header, which `properties.retryAfter` repeats. |
| 503 | - | Silktide is busy. Retry after the number of seconds in the `Retry-After` header. |

## Access

- Permission: Can admin this dashboard / snapshot
- Plan feature: none
- Edition: Silktide 4 only
- Cost: free
- Stability: stable, since 1.0.0

## Example: Delete a report

```bash
curl -X DELETE "https://api.eu.silktide.com/v1/reports/5" \
  -H "Authorization: silktide token=$SILKTIDE_API_KEY"
```
