SlackChannels
Delete Slack channel
Remove a Slack channel subscription from the organization.
DELETE /app/integrations/slack/channels
Permanently removes a Slack channel subscription for the given dashboard and contact key. Identify the row with dashboardId + urlHash.
Parameters may be sent as query string and/or JSON body (body values win when both are present).
If this was the channel's last subscription in the organization, the unique-channel soft-limit slot is released. Related tokens and suppression for that endpoint are removed.
Requires the admin or subscriber role and the integrations feature entitlement.
Request
See API Basics for required headers.
Body / query parameters
| Field | Type | Required | Description |
|---|---|---|---|
dashboardId | uuid | Yes | Dashboard the subscription belongs to. |
urlHash | string | Yes | 64-character lowercase hex contact hash from List Slack channels. |
Sample request
curl -X DELETE https://api.statusdashboard.com/app/integrations/slack/channels \
-H "Authorization: Bearer bcf847abf5c6:def456" \
-H "Content-Type: application/json" \
-d '{
"dashboardId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"urlHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
}'Sample response
Status: 204 No Content
No response body.
Error responses
| Status | When |
|---|---|
400 | Invalid parameters or missing dashboardId / urlHash. |
403 | Requires admin or subscriber role, or integrations disabled. |
404 | Channel subscription not found. |