Returning.AI
  1. Returning.AI
  2. Channel
Returning.AI
  • Returning.AI
    • Auth
      • register
      • verify email
      • login
    • User
      • Get my user
    • Server
      • Swagger APIs
        • channel list of server
        • user list of server
        • DM channel list of server
        • role list of server
      • create new server
      • get my servers
      • update server
    • Category
      • create new category
      • update category
      • delete category
    • Role
      • Swagger APIs
        • get role list of user on a server
        • add role to a user on a server
        • remove role from a user on a server
      • create new role
      • update role
      • delete role
    • Channel
      • Swagger APIs
        • message list of channel
        • post dm message to channel
      • create new channel
        POST
      • update channel
        PUT
      • delete channel
        DELETE
    • Language Setting
      • create new language setting
      • update language setting
      • delete language setting
    • Leaderboard
      • create new leaderboard
      • update leaderboard
      • delete leaderboard
    • Badge
      • Swagger APIs
        • badge list of server
        • badge list of user on a server
      • create new badge
      • update badge
      • delete badge
      • award badge to user
      • remove badge from user
    • Gamification
      • Swagger APIs
        • get xp of user on a server
        • add xp to user on a server
        • set xp to user on a server
        • deduct xp from user on a server
      • set xp setting
      • set tier setting
      • add new tier
      • update tier
      • delete tier
    • Api Token
      • Swagger APIs
        • get api token
        • generate api token
        • delete api token
    • Custom Userfields
      • Swagger APIs
        • add custom userfields
        • update custom userfields
    • Integration
      • get channels list
      • send message
  1. Returning.AI
  2. Channel

create new channel

Developing
POST
/channels

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
serverId
string 
required
title
string 
required
iframeEnabled
boolean 
required
embedWidgetEnabled
boolean 
required
Example
{
  "serverId": "{{serverId}}",
  "title": "IC Markets",
  "iframeEnabled": true,
  "embedWidgetEnabled": true
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.returning.ai/api/v1/channels' \
--header 'Content-Type: application/json' \
--data-raw '{
    "serverId": "",
    "title": "IC Markets",
    "iframeEnabled": true,
    "embedWidgetEnabled": true
}'

Responses

🟢200Success
application/json
Body
meta
object 
required
success
boolean 
required
message
string 
required
devMessage
string 
required
body
object 
required
title
string 
required
permissions
array[string]
required
userId
string 
required
serverId
string 
required
channelType
string 
required
_id
string 
required
createdAt
string 
required
updatedAt
string 
required
__v
integer 
required
Example
{
  "meta": {
    "success": true,
    "message": "Channel has been created successfully",
    "devMessage": "Channel has been created successfully"
  },
  "body": {
    "title": "Chit Chat",
    "permissions": [],
    "userId": "1",
    "serverId": "669b462658695ff095d431af",
    "channelType": "open",
    "_id": "66a28249fe1c8797121428c8",
    "createdAt": "2024-07-25T16:50:17.610Z",
    "updatedAt": "2024-07-25T16:50:17.610Z",
    "__v": 0
  }
}
Modified at 2024-08-06 04:44:55
Previous
post dm message to channel
Next
update channel