Components
Delete component
Permanently delete a component from the organization.
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 and Dashboard scope.
Path parameters
| Parameter | Type | Description |
|---|---|---|
id | string | UUID of the component to delete. |
Request
See API Basics for required headers.
Sample request
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. |