---
title: "POST /channel.join"
method: POST
path: "/channel.join"
tags: ["channel"]
---

# POST /channel.join

`POST /channel.join`

当前用户加入指定讨论组。

## Request body

- object
  - `channel_id` string, required — 讨论组 id

## Response `200`

request success

- Channel
  - `id` string, required
  - `team_id` string, required
  - `uid` string, required
  - `vchannel_id` string, required — 聊天会话 id
  - `name` string, required — 讨论组名称
  - `topic` string, required — 讨论组话题
  - `type` 'normal' | 'session' | 'p2p', required — 聊天会话类型
  - `general` boolean, required — 讨论组是否为`所有人`讨论组？
  - `private` boolean, required — 讨论组是否为私密讨论组？
  - `is_active` boolean, required — 会话是否有效
  - `is_member` boolean, required — 当前用户是否为讨论组成员？
  - `member_uids` ResponseObjectId[], required — 讨论组成员 id 列表
  - `latest_ts` integer, required — 讨论组最新一条消息的 ts

## Other responses

- `default` — request fail

## Changes

- **2017-04-19** `fd4c7a508190` — 1 info
  - api tag `channel` added
- **2017-04-18** `b37660ad33e5` — 1 info
  - api tag `channel` removed
- **2017-04-04** `4751e3946b90` — 1 info
  - api tag `channel` added
- **2017-03-23** `139603e57e31` — 1 breaking, 1 info
  - removed the success response with the status `204`
  - added the success response with the status `200`
- **2017-03-13** `ef71aa691171` — 1 breaking, 2 info
  - removed the success response with the status `200`
  - api tag `channel` removed
  - added the success response with the status `204`

[Change history](https://skmtc.dev/bearyinnovative/apis/beary-openapi/changes/channel.join/post.md)

---

[API](https://skmtc.dev/bearyinnovative/apis/beary-openapi.md) · [All operations](https://skmtc.dev/bearyinnovative/apis/beary-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bearyinnovative/beary-openapi/revisions/6e42a0e2d730/schema)