---
title: "Delete a Slack channel binding"
method: DELETE
path: "/api/v1/slack_channel_bindings/{channel}"
---

# Delete a Slack channel binding

`DELETE /api/v1/slack_channel_bindings/{channel}`

Removes the binding between a Slack channel and its associated team. The
channel is identified by its Slack channel ID together with the `slack_team_id`
that scopes it to a specific Slack workspace. Removing the binding does not
delete the bound team or any conversation threads scoped to it; decommission
those resources separately if required.

The caller must have team-manage rights on the team the channel is currently
bound to. Returning 403 indicates insufficient permission; returning 404
indicates the binding does not exist or is not visible to the caller.

The REST endpoint returns 204 No Content on success. The script binding
(`slack.channel_bindings.delete`) returns a confirmation object so script
callers can verify success without an additional fetch. Both paths are
idempotent — retrying after a partial failure is safe.

## Path parameters

- `channel` string, required

## Response `200`

Successful response

- object — Deletion confirmation returned by the script binding. The REST endpoint returns 204 No Content with no body.
  - `channel` string, required — Slack channel ID of the binding that was deleted.
  - `deleted` boolean, required — Always `true` when the binding was successfully removed.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden; The Slack integration referenced by this binding is not visible to the caller
- `404` — Slack channel binding not found
- `422` — Invalid parameters

---

[API](https://skmtc.net/archastro/apis/archastro-platform-api.md) · [All operations](https://skmtc.net/archastro/apis/archastro-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/archastro/archastro-platform-api/versions/a8772b442f86/schema)