Delete Channel

Delete a Microsoft Team channel using team ID and channel ID.

Updated Feb 19, 2026
One-click install
npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill delete-channel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Delete Channel
Source: https://github.com/naftiko/microsoft-teams-sandbox/tree/main/skills/delete-channel
Command: npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill delete-channel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows for the permanent deletion of specific channels within a Microsoft Team, helping to declutter and manage team structures effectively.

Core Features & Use Cases

  • Channel Removal: Delete any channel except the default 'General' channel.
  • Permanent Deletion: Understand that this action is irreversible and removes all associated messages and files.
  • Use Case: If a project channel is no longer active, use this Skill to remove it from the team to maintain organization.

Quick Start

Use the delete channel skill to remove the channel with ID '[email protected]' from the team with ID 'e1b3c5a7-9d2f-4b6e-8c1a-3f5d7e9b2a4c'.

Frequently Asked Questions about Delete Channel

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I permanently delete a Microsoft Teams channel?

To permanently delete a Microsoft Teams channel, you use the specific team ID and channel ID as path parameters to execute the removal. This action is irreversible and removes all associated messages and files.

Can I delete the General channel in Microsoft Teams?

No, you cannot delete the default 'General' channel in Microsoft Teams. The channel deletion skill only supports removing custom channels to maintain workspace organization.

What do I need to remove a channel from a Microsoft Team?

You need the unique team ID and the specific channel ID to remove a channel from a Microsoft Team. These precise path parameters are required to execute the permanent removal.

Are messages and files preserved when a Teams channel is deleted?

No, messages and files are not preserved when a Teams channel is deleted. The deletion is permanent and irreversible, removing all associated content from the workspace.

Why should I delete inactive channels in Microsoft Teams?

Deleting inactive channels in Microsoft Teams helps declutter team structures and maintain workspace organization. Removing channels that are no longer active ensures effective workspace management.