---
title: "POST /channels/{channelID}/children"
method: POST
path: "/channels/{channelID}/children"
tags: ["channel"]
---

# POST /channels/{channelID}/children

`POST /channels/{channelID}/children`

子チャンネルを作成します。

## Request body

- CreateChannelChild
  - `name` string, required — チャンネル名

## Response `201`

正常にチャンネルが作成できました。作成されたチャンネルを返します。

- Channel
  - `channelId` string, uuid — チャンネルUUID
  - `name` string — チャンネル名
  - `member` string[] — UUIDの配列
  - `parent` string, uuid — 親の階層のチャンネルUUID
  - `topic` string — チャンネルトピック
  - `children` string[] — UUIDの配列
  - `visibility` boolean — チャンネルの可視状態
  - `force` boolean — 強制通知チャンネルか
  - `private` boolean — プライベートチャンネルか
  - `dm` boolean — ダイレクトメッセージチャンネルか

## Other responses

- `400` — チャンネルが作成できませんでした。リクエスト内容が不正です。
- `403` — チャンネルが作成できませんでした。権限がありません。
- `404` — チャンネルが作成できませんでした。指定したチャンネルは存在しません。
- `409` — チャンネルが作成できませんでした。指定したチャンネル名のチャンネルは既に存在します。

## Changes

- **2019-09-09** `f291e1b35a23` — 1 breaking
  - request body became required
- **2019-07-24** `66a69a1387ed` — 1 info
  - api operation id `createChannelChild` was added
- **2019-07-05** `6956f2622a20` — 10 info
  - api operation id `createChannelChild` removed and replaced with ``
  - the endpoint scheme security `traqOAuth2` was added to the API
  - endpoint reactivated
  - added optional request body
  - …6 more

[Change history](https://skmtc.dev/traptitech/apis/traq-api/changes/channels/:channelID/children/post.md)

---

[API](https://skmtc.dev/traptitech/apis/traq-api.md) · [All operations](https://skmtc.dev/traptitech/apis/traq-api/llms.txt) · [OpenAPI document](https://skmtc.dev/traptitech/apis/traq-api/revisions/535e1f620613?raw)