Roles

Get all roles of a user

GET https://yourwebsite.com/api/users/<user>/roles

Path Parameters

Name	Type	Description
user*

200: OK

[
    {
        "id": "2",
        "discordRoleID": "673855784005795840",
        "name": "Admin",
        "slug": "admin",
        "priority": "99",
        "expiryDate": "1000-01-01 00:00:00", // Permanent role
    },
    {
        "id": "3",
        "discordRoleID": "673855784005795841",
        "name": "VIP",
        "slug": "vip",
        "priority": "5",
        "expiryDate": "2023-09-03 12:30:45", // Temporary role
    }
]

404: Not Found User not found

{
    "status": false,
    "error": "USER_NOT_FOUND",
    "message": "User not found!"
}

Add role to user

POST https://yourwebsite.com/api/users/<user>/roles

Path Parameters

Name	Type	Description
user*

Request Body

Name	Type	Description
roleID*
expiryDate	String

200: OK

[
    {
        "id": "2",
        "discordRoleID": "673855784005795840",
        "name": "Admin",
        "slug": "admin",
        "priority": "99",
        "expiryDate": "1000-01-01 00:00:00", // Permanent role
    },
    {
        "id": "3",
        "discordRoleID": "673855784005795841",
        "name": "VIP",
        "slug": "vip",
        "priority": "5",
        "expiryDate": "2023-09-03 12:30:45", // Temporary role
    }
]

404: Not Found User not found

{
    "status": false,
    "error": "USER_NOT_FOUND",
    "message": "User not found!"
}

Update user roles

PATCH https://yourwebsite.com/api/users/<user>/roles/<role>

Path Parameters

Name	Type	Description
user*
role	String	Role ID

Request Body

Name	Type	Description
roleID*
expiryDate	String

200: OK

[
    {
        "id": "2",
        "discordRoleID": "673855784005795840",
        "name": "Admin",
        "slug": "admin",
        "priority": "99",
        "expiryDate": "1000-01-01 00:00:00", // Permanent role
    },
    {
        "id": "3",
        "discordRoleID": "673855784005795841",
        "name": "VIP",
        "slug": "vip",
        "priority": "5",
        "expiryDate": "2023-09-03 12:30:45", // Temporary role
    }
]

404: Not Found User not found

{
    "status": false,
    "error": "USER_NOT_FOUND",
    "message": "User not found!"
}

Remove role from user

DELETE https://yourwebsite.com/api/users/<user>/roles/<role>

Path Parameters

Name	Type	Description
user*
role*	String	Role ID

200: OK

[
    {
        "id": "2",
        "discordRoleID": "673855784005795840",
        "name": "Admin",
        "slug": "admin",
        "priority": "99",
        "expiryDate": "1000-01-01 00:00:00", // Permanent role
    },
    {
        "id": "3",
        "discordRoleID": "673855784005795841",
        "name": "VIP",
        "slug": "vip",
        "priority": "5",
        "expiryDate": "2023-09-03 12:30:45", // Temporary role
    }
]

404: Not Found User not found

{
    "status": false,
    "error": "USER_NOT_FOUND",
    "message": "User not found!"
}