- Returning.AI
- Auth
- Server
- Role
- Channel
- Badge
- Integration
update role
Developing
PUT
/roles/{id}
Request
Path Params
id
string
required
Example:
682d61dfd843de46566c9eab
Header Params
x-api-key
string
required
Body Params application/json
class
string
required
title
string
required
order
integer
required
billable
boolean
required
server_permissions
object
required
server_administrator
boolean
required
allow_dm
boolean
required
create_invite
boolean
required
warn_members
boolean
required
suspend_members
boolean
required
ban_members
boolean
required
broadcast_messages
boolean
required
overwrite_language
boolean
required
channel_permissions
object
required
post_messages
boolean
required
attach_files
boolean
required
allow_mentions
boolean
required
manage_messages
boolean
required
pinable
boolean
required
share_links
boolean
required
share_Attachments
boolean
required
Example
{
"class": "blue",
"title": "Manager 2",
"order": 1,
"billable": false,
"server_permissions": {
"server_administrator": false,
"allow_dm": false,
"create_invite": false,
"warn_members": false,
"suspend_members": false,
"ban_members": false,
"broadcast_messages": false,
"overwrite_language": false
},
"channel_permissions": {
"post_messages": false,
"attach_files": false,
"allow_mentions": false,
"manage_messages": false,
"pinable": false,
"share_links": false,
"share_Attachments": 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 PUT 'https://rai-api.returning.ai/api/v1/roles/682d61dfd843de46566c9eab' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
"class": "blue",
"title": "Manager 2",
"order": 1,
"billable": false,
"server_permissions": {
"server_administrator": false,
"allow_dm": false,
"create_invite": false,
"warn_members": false,
"suspend_members": false,
"ban_members": false,
"broadcast_messages": false,
"overwrite_language": false
},
"channel_permissions": {
"post_messages": false,
"attach_files": false,
"allow_mentions": false,
"manage_messages": false,
"pinable": false,
"share_links": false,
"share_Attachments": false
}
}'Responses
🟢200Success
application/json
Body
meta
object
required
success
boolean
required
message
string
required
devMessage
string
required
body
object
required
_id
string
required
order
integer
required
billable
boolean
required
title
string
required
description
string
required
server_permissions
object
required
channel_permissions
object
required
class
string
required
createdAt
string
required
updatedAt
string
required
__v
integer
required
Example
{
"meta": {
"success": true,
"message": "Role has been updated successfully",
"devMessage": "Role has been updated successfully"
},
"body": {
"_id": "{_id}",
"order": 2,
"billable": false,
"title": "Moderator",
"description": "Role with permissions to moderate the server",
"server_permissions": {
"allow_dm": true,
"create_invite": true,
"kick_members": true,
"ban_members": true,
"manage_roles": true,
"manage_channels": true,
"server_administrator": true,
"_id": "66a27b91fe1c879712142894"
},
"channel_permissions": {
"view_message_history": true,
"manage_messages": true,
"allow_mentions": true,
"post_messages": true,
"post_analysis": true,
"attach_files": true,
"_id": "{_id}"
},
"class": "blue",
"serverId": "{_id}",
"createdAt": "2024-07-25T16:17:27.299Z",
"updatedAt": "2024-07-25T16:21:37.761Z",
"__v": 0
}
}