---
title: "Delete Room"
slug: "delete-room"
updated: 2026-09-03T14:50:33Z
published: 2026-09-03T14:50:33Z
canonical: "developer.rocket.chat/delete-room"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Room

Post/api/v1/rooms.delete

Delete a room from the workspace. The following permissions are required:

- `delete-c`: To delete a public room.
- `delete-d`: To delete direct messages.
- `delete-p`: To delete private rooms.
- `delete-team`: To delete a team.
- `delete-team-channel`: To delete a channel within a team, also requires the `delete-c` permission.
- `delete-team-group`: To delete a private channel within a team, also requires the `delete-p` permission.

> You can't use this endpoint to delete a team's main room. Use [Delete a Team endpoint](https://developer.rocket.chat/apidocs/delete-a-team) instead.

### Changelog

| Version | Description |
| --- | --- |
| 5.4.0 | Added |

Header parametersX-Auth-TokenstringRequired

The `authToken` of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-IdstringRequired

The `userId` of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ

Body parameters<select class='api-response-data' aria-label='Media type'><option value='d1ffeebf-5a2e-410a-9844-8cfb546f944e'>application/json</option>
</select>object  roomIdstring    Required

The room ID that you want to delete.

ExampleByehQjC44FwMeiLbX

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='a797be38-988a-4513-8615-45213913fbc2'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='50b5831d-a10a-4b36-9e4e-ba702ee497a5'>Success</option>
</select>Success

```json
{
  "success": true
}
```

object  successboolean    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='386c374d-b2a9-4550-9889-486cfd4df93e'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='57c8a2f8-9b11-4d79-a7ea-fd3cdb4e4371'>Example 1: Missing roomId</option>
<option value='3a459272-da0e-4a69-b4af-fd49b843fb3e'>Example 2: Missing Permission</option>
<option value='b766164c-e288-4f01-9dd6-4e60efa4a0b0'>Example 3: Cannot Delete Team Channel</option>
</select>Example 1: Missing roomId

```json
{
  "success": false,
  "error": "The 'roomId' param is required"
}
```

Example 2: Missing Permission

```json
{
  "success": true,
  "error": "string"
}
```

Example 3: Cannot Delete Team Channel

```json
{
  "success": false,
  "error": "Cannot delete a team channel [error-cannot-delete-team-channel]",
  "errorType": "error-cannot-delete-team-channel",
  "details": {
    "method": "eraseRoom"
  }
}
```

object  successboolean    
errorstring    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='8ce9e718-2f39-4dd2-8c6f-9d6e11d502f0'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='454e2a2f-ce5a-4bc5-8036-aa5dfc7a2c11'>Authorization Error</option>
</select>Authorization Error

```json
{
  "status": "error",
  "message": "You must be logged in to do this."
}
```

object  statusstring    
messagestring