Linked Roles
Discord linked roles backed by Omniplex badges
GET
Returns whether Discord linked roles are enabled, the application to authorize, and the badges servers can require.
Success
application/json- response
badges?array<>The badges Discord servers can use as linked-role requirements
client_id?stringThe Discord application to authorize
enabled?booleanWhether linked roles are configured
curl -X GET 'https://spider.omniplex.gg/linked-roles'Example Response
{ "badges": [ { "description": "string", "id": "string", "name": "string" } ], "client_id": "string", "enabled": true}POST
Exchanges a Discord OAuth2 code (scopes identify and role_connections.write) and sets the user's Omniplex role connection from their linked-role badges. The redirect URI must be /linked-roles/callback on an allowed frontend.
application/json- body
code?stringThe OAuth2 code Discord returned
redirect_uri?stringThe redirect URI used for the authorization
Success
application/json- response
badges?array<>The names of the linked-role badges this user has
user_id?stringThe connected Discord user ID
username?stringThe connected Discord username
curl -X POST 'https://spider.omniplex.gg/linked-roles/connect' \ -H 'Content-Type: application/json' \ -d '{}'Example Response
{ "badges": [ "string" ], "user_id": "string", "username": "string"}