GET
/api/v1/server/roles/{roleId}
Request
Response
200
Success
Authorization
AuthorizationstringrequiredYour API token as
Bearer YOUR_TOKEN. Create one in your server's dashboard settings.Path parameters
roleIdstringrequiredResponse
200 Success
createdAtintegerrequiredWhen the role was created.
extraPermissionsstringrequiredExtra permission bitfield as a decimal string.
idstringrequiredUnique ID.
namestringrequiredRole name.
permissionsstringrequiredPermission bitfield as a decimal string.
priorityintegerrequiredRank in the role hierarchy. Higher outranks lower.
serverIdstringrequiredServer ID.
colourstring | nullHex colour.
linkedDiscordRoleIdstring | nullDiscord role kept in sync with this one.
Errors
| Status | Meaning |
|---|---|
400 | Invalid request. validation_failed lists each invalid field in details.fields. |
401 | Missing, invalid or expired token |
404 | Not found |
429 | Rate limited. See Retry-After and details. |
500 | Internal server error |