- Introduction
- Quick Start
- Auth
- Users
- Get All UsersGET
- Create a UserPOST
- Retrieve an Existing UserGET
- Delete an Existing UserDELETE
- Update an Existing UserPATCH
- Get Current UserGET
- Update Current UserPATCH
- Get Current User DevicesGET
- Retrieve User Devices by User IDGET
- Update Own Profile ImagePOST
- Update User ImagePOST
- Reset User PasswordPATCH
- Get User Login HistoryGET
- Get All Users
- Staff
- Teachers
- Students
- Roles
- Classes
- Statistics
- Letters
- Letter Actions
- Files
- Schemas
Create a Role
Developing
POST
/roles
Request
Body Params application/json
Example
{
"name": "Admin",
"icon": "ri-shield-user-line",
"color": "#ffffff",
"permissions": [
"read:letter"
]
}Request Code 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://sims.sman1samarinda.sch.id/api/roles' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Admin",
"icon": "ri-shield-user-line",
"color": "#ffffff",
"permissions": [
"read:letter"
]
}'Responses
🟢201Created
application/json
Body
Example
{
"success": true,
"message": "OK.",
"meta": {},
"errors": [],
"result": {
"id": "0afadfbfbd300ef5847e4eb4",
"name": "Admin",
"icon": "ri-shield-user-line",
"color": "#ffffff",
"permissions": [
"read:letter"
],
"createdAt": "2025-11-26T09:42:43.294Z",
"updatedAt": "2025-11-26T09:42:43.294Z"
}
}🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠409Conflict
🔴500Server Error
Modified at 2025-11-28 07:54:47