Core
  1. Roles
Core
  • Introduction
    • What is Core
    • HTTP Statuses
    • Request
    • Responses
    • Meta
    • Limit & Pagination
    • Query Parameters
  • Quick Start
    • Letters
  • Auth
    • Sign In with Email and Password
      POST
    • Get the Current Session
      GET
    • Sign Out the Current User
      POST
  • Users
    • Get All Users
      GET
    • Create a User
      POST
    • Retrieve an Existing User
      GET
    • Delete an Existing User
      DELETE
    • Update an Existing User
      PATCH
    • Get Current User
      GET
    • Update Current User
      PATCH
    • Get Current User Devices
      GET
    • Retrieve User Devices by User ID
      GET
    • Update Own Profile Image
      POST
    • Update User Image
      POST
    • Reset User Password
      PATCH
    • Get User Login History
      GET
  • Staff
    • Get All Staff
    • Retrieve an Existing Staff
    • Create a Staff
    • Delete an Existing Staff
    • Update an Existing Staff
  • Teachers
    • Get All Teachers
    • Retrieve an Existing Teacher
    • Create a Teacher
    • Delete an Existing Teacher
    • Update an Existing Teacher
  • Students
    • Get All Students
    • Retrieve an Existing Student
    • Create a Student
    • Delete an Existing Student
    • Update an Existing Student
    • Import Bulk Students
  • Roles
    • Get All Roles
      GET
    • Create a Role
      POST
    • Retrieve an Existing Role
      GET
    • Update an Existing Role
      PATCH
    • Delete an Existing Role
      DELETE
    • Get All Eligible Users for Role
      GET
    • Get All Members of Role
      GET
    • Add Bulk Member to Role
      POST
    • Remove Bulk Members from Role
      DELETE
  • Classes
    • Get All Classes
    • Create a Class
    • Delete an Existing Student Copy
    • Create a Class Copy
  • Statistics
    • Teachers
      • Get Teacher Gender Stats
      • Get Teacher Religion Distribution
      • Get Teacher Employment Stats
      • Get Teacher Age Stats
    • Students
      • Get Student Gender Stats
      • Get Student Religion Distribution
      • Get Student Weight Stats
      • Get Student Height Stats
      • Get Student Age Stats
      • Get Student Transportation Stats
      • Get Student Class Stats
    • Staffs
      • Get Staffs Gender Stats
      • Get Staffs Religion Distribution
      • Get Staffs Age Stats
      • Get Staffs Employment Stats
    • Users
      • Retrieve User Summary
    • Get All Stats
  • Letters
    • Get All Letters
    • Retrieve an Existing Letter
    • Create a Letter
    • List User Letter
    • List Current User Letter
    • List Recipients
  • Letter Actions
    • Initiate a Letter Action
  • Files
    • Create a Presigned URL
  • Schemas
    • Schemas
      • Letter
        • LetterHistory
        • LetterStatus
        • LetterType
      • User
        • UserProfile
      • Address
      • Meta
      • Base
      • bloodType
      • Religion
      • Gender
      • ParentInfo
      • Error
      • GenderStats
      • ReligionDistribution
      • WeightStats
      • HeightStats
      • AgeStats
      • TransportationStats
      • ClassStats
      • EducationHistoryObject
      • EmploymentStats
      • Location
      • EconomyStats
      • Actor
    • Model
      • User
      • Teacher
      • Staff
      • Student
      • Letter
      • Class
      • Roles
    • LoginHistory
  1. Roles

Update an Existing Role

Developing
PATCH
/roles/{role_id}
Update a role.

Request

Path Params

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 PATCH 'https://sims.sman1samarinda.sch.id/api/roles/edbe8f637a0dd449b4e924d1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Admin",
    "icon": "ri-shield-user-line",
    "color": "#ffffff",
    "permissions": [
        "read:letter"
    ]
}'

Responses

🟢200OK
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"
    }
}
🟠401Unauthorized
🟠403Forbidden
🔴500Server Error
Modified at 2025-11-29 07:10:10
Previous
Retrieve an Existing Role
Next
Delete an Existing Role
Built with