- Returning.AI
- Auth
- User
- Server
- Category
- Role
- Channel
- Language Setting
- Leaderboard
- Badge
- Gamification
- Api Token
- Custom Userfields
- Integration
create new category
Developing
POST
/categories
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
description
string
required
private
boolean
required
Example
{
"serverId": "{{serverId}}",
"title": "General Discussion",
"description": "This is a category for general discussion.",
"private": false
}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/categories' \
--header 'Content-Type: application/json' \
--data-raw '{
"serverId": "",
"title": "General Discussion",
"description": "This is a category for general discussion.",
"private": false
}'Responses
🟢200Success
application/json
Body
meta
object
required
success
boolean
required
message
string
required
devMessage
string
required
body
object
required
serverId
string
required
title
string
required
description
string
required
private
boolean
required
roles
array[string]
required
users
array[string]
required
owner
object
required
categoryOrder
integer
required
translationAllowed
boolean
required
_id
string
required
createdAt
string
required
updatedAt
string
required
__v
integer
required
Example
{
"meta": {
"success": true,
"message": "Category has been created successfully",
"devMessage": "Category has been created successfully"
},
"body": {
"serverId": "669b462658695ff095d431af",
"title": "General Discussion",
"description": "This is a category for general discussion.",
"private": false,
"roles": [],
"users": [],
"owner": {
"id": "1"
},
"categoryOrder": 0,
"translationAllowed": false,
"_id": "66a27e08fe1c87971214289d",
"createdAt": "2024-07-25T16:32:08.449Z",
"updatedAt": "2024-07-25T16:32:08.449Z",
"__v": 0
}
}Modified at 2024-07-27 16:49:22