# Remove a dashboard

Permanently deletes an existing dashboard.

[endpoint]
base_url = "https://telemetry.betterstack.com"
path = "/api/v2/dashboards/{id}"
method = "DELETE"

[[path_param]]
name = "id"
description = "The unique identifier of the dashboard to delete."
required = true
type = "string"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
required = true
type = "string"
[/endpoint]

[responses]
[[response]]
status = 204
description = "The dashboard was successfully deleted. No content is returned."

[[response]]
status = 401
description = "Invalid or missing authentication token."

[[response]]
status = 404
description = '''Resource with the provided ID was not found.'''
body = '''
{
  "errors": "Resource with the provided ID was not found"
}
'''
[/responses]

## Example cURL

```shell
[label Example]
curl --request DELETE \
     --url "https://telemetry.betterstack.com/api/v2/dashboards/123" \
     --header "Authorization: Bearer $TOKEN"
```
