---
title: "Convert Team to Channel"
slug: "convert-team-to-channel"
updated: 2026-06-01T06:32:04Z
published: 2026-06-01T06:32:04Z
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.

# Convert Team to Channel

Post/api/v1/teams.convertToChannel

Convert a team to a channel. Permission required: `convert-team`

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='b0a7d039-b495-462e-ab60-5215aebe67b2'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='99e1f280-6464-4b1e-9ce5-516ccd5b6c70'>Example</option>
</select>Example

```json
{
  "teamId": "612b8ae982d286c3d1f5db31"
}
```

object  teamIdstring    Required

The team ID that you want to convert to a channel.

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='7e2cad7c-11a8-4b62-8b2c-7ee526dfc05c'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='6b32ef2e-c905-4e34-981e-3720ac40d147'>Success</option>
</select>Success

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

object  successboolean    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='0bb40c05-4521-4a3d-8b29-fa201940764d'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='b1535a6a-9d83-4f88-9ce7-817413d264e5'>Invalid Team Id</option>
<option value='448ab0b7-3780-4e8e-a963-9da738bffafc'>Team Id or Team name is required</option>
</select>Invalid Team Id

```json
{
  "success": false,
  "error": "team-does-not-exist"
}
```

Team Id or Team name is required

```json
{
  "success": false,
  "error": "missing-teamId-or-teamName"
}
```

object  successboolean    
errorstring    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='438514a9-5bb4-425f-94d9-035d24abe1ea'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='1b408755-b0e8-4085-a65e-6e126deec431'>Authorization Error</option>
</select>Authorization Error

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

object  statusstring    
messagestring