# Delete component

Permanently delete a component from the organization.

Source: https://statusdashboard.com/docs/api/status-dashboards/components/delete

`DELETE /app/components/{id}`

Permanently deletes a component. Requires the **admin** role.

When a component is deleted, the platform automatically:

* Removes it from every status dashboard in the organization that included it, including any widget component filters for that dashboard.
* Cleans up subscriber records tied to that component on affected dashboards — for example, removing subscribers who only followed that component, or pruning the component from multi-component subscriptions.
* Deletes the component record itself.

The following are **not** changed:

* **Existing events** in admin are not deleted or rewritten. Events that referenced the component keep their stored name and severity snapshots from when they were last associated.
* **New events** cannot reference a deleted component ID.

For how deletion affects public status page visibility and event history, see [Deleting components](/docs/components#deleting-components) and [Dashboard scope](/docs/status-dashboards/components#dashboard-scope).

***

## Path parameters
| Parameter | Type   | Description                      |
| --------- | ------ | -------------------------------- |
| `id`      | string | UUID of the component to delete. |

***

## Request
See [API Basics](/docs/api) for required headers.

***

## Sample request
```bash
curl -X DELETE https://api.statusdashboard.com/app/components/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer bcf847abf5c6:def456"
```

## Sample response
**Status: `204 No Content`**

No response body.

***

## Error responses
| Status | When                                                  |
| ------ | ----------------------------------------------------- |
| `403`  | Insufficient permissions.                             |
| `404`  | No component with that ID exists in the organization. |