melonly logomelonly logo
melonly logo
Dashboard
Log in

Get a Role

Gets one role.

GET

/api/v1/server/roles/{roleId}

Request

curl -X GET "https://api.melonly.com/api/v1/server/roles/{roleId}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

200

Success

{
  "data": {
    "colour": "#11d982",
    "createdAt": 1700000000000,
    "extraPermissions": "0",
    "id": "7314779729419046912",
    "linkedDiscordRoleId": "1100000000000000000",
    "name": "WE DEM MODZ!!!!!!",
    "permissions": "6",
    "priority": 4,
    "serverId": "7294057520392310784"
  }
}

Authorization

Authorizationstringrequired
Your API token as Bearer YOUR_TOKEN. Create one in your server's dashboard settings.

Path parameters

roleIdstringrequired

Response

200 Success

createdAtintegerrequired
When the role was created.
extraPermissionsstringrequired
Extra permission bitfield as a decimal string.
idstringrequired
Unique ID.
namestringrequired
Role name.
permissionsstringrequired
Permission bitfield as a decimal string.
priorityintegerrequired
Rank in the role hierarchy. Higher outranks lower.
serverIdstringrequired
Server ID.
colourstring | null
Hex colour.
linkedDiscordRoleIdstring | null
Discord role kept in sync with this one.

Errors

StatusMeaning
400Invalid request. validation_failed lists each invalid field in details.fields.
401Missing, invalid or expired token
404Not found
429Rate limited. See Retry-After and details.
500Internal server error