Create a channel or category

POST

/v1/communities/{id}/channels

curl --request POST \
  --url https://api.gampeon.com/v1/communities/1/channels \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "kind": "category", "name": "example", "topic": "example", "parentId": 1, "overrides": [ { "roleId": 1, "allow": 1, "deny": 1 } ], "userLimit": 1 }'

• Production

Needs manageChannels. Text channel names are lowercase (spaces become -). Channels inherit the overrides of their category, then apply their own. Announcement channels start read-only for everyone. Voice channels have no messages; userLimit caps how many people can be in one at once. Only viewChannels, sendMessages, manageMessages, connect, speak, stream can be set per channel. Up to 100 channels.

Not available with access tokens.

Authorizations

• session

Parameters

Path Parameters

id

required

integer

>= 1

Community ID

Request Body^required

Media typeapplication/json

object

kind

required

string

Allowed values: category text announcement voice

name

required

string

>= 1 characters <= 32 characters

topic

string

<= 300 characters

parentId

One of:

integer

Category ID

integer

null

null

overrides

Array<object>

object

roleId

required

integer

allow

required

Bits allowed in this channel

integer

deny

required

Bits denied in this channel

integer

userLimit

Only voice channels. 0 is no limit

integer

<= 99

Responses

201

Created

Media typeapplication/json

object

id

required

integer

Example ^generated

{
  "id": 1
}

400

Error codes: invalid_field

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

401

Error codes: unauthorized

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

403

Error codes: token_not_allowed, missing_permission

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

409

Error codes: channel_limit_reached

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}