Bindings

Bindings assign Discord roles from Roblox data. These endpoints let you read the configured bindings and manage them programmatically. For the concept and the dashboard UI, see Bindings. list reads the guild from the X-Guild-ID header. The write endpoints take guild_id in the body.

Binding types

`binding_type`	Required fields
`group_rank`	`roblox_group_id`, `min_rank`, `max_rank` (ranks 0 to 255)
`gamepass`	`roblox_gamepass_id`
`asset`	`roblox_asset_id`
`badge`	`roblox_badge_id`
`account_age`	`account_age_platform`, `account_age_min_days`

List bindings

GET /bindings/list

string

required

The guild to read. Must match your key’s guild.

Each binding is enriched with the resolved Discord role name and, for group bindings, the Roblox group name.

object

Show binding properties

number

string

number | null

string

number | null

curl "https://api.technified.xyz/api/v1/bindings/list" \
  -H "X-API-Key: $TECHNIFIED_API_KEY" \
  -H "X-Guild-ID: $GUILD_ID"

Add a binding

POST /bindings/add

string

required

string

required

The Discord role to assign.

string

required

One of group_rank, gamepass, asset, badge, account_age.

number

Required for group_rank.

number

Required for group_rank. 0 to 255.

number

Required for group_rank. Must be at least min_rank.

number

Required for gamepass.

number

Required for asset.

number

Required for badge.

string

discord or roblox. Required for account_age.

number

Required for account_age.

number

Optional ordering hint when bindings overlap.

The Roblox group, gamepass, asset, or badge is validated against Roblox before the binding is saved. An invalid ID returns 400.

curl "https://api.technified.xyz/api/v1/bindings/add" \
  -H "X-API-Key: $TECHNIFIED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "guild_id": "'$GUILD_ID'",
    "discord_role_id": "111111111111111111",
    "binding_type": "group_rank",
    "roblox_group_id": 1200769,
    "min_rank": 50,
    "max_rank": 99
  }'

curl "https://api.technified.xyz/api/v1/bindings/add" \
  -H "X-API-Key: $TECHNIFIED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "guild_id": "'$GUILD_ID'",
    "discord_role_id": "222222222222222222",
    "binding_type": "gamepass",
    "roblox_gamepass_id": 123456
  }'

Update a binding

PATCH /bindings/update

number

required

number

Remove a binding

DELETE /bindings/remove/:bindingId

number

required

The id of the binding to delete.

Test a binding against a user

Check whether a specific verified member would match an existing group binding. Useful for debugging “why does this person not have the role”.

POST /bindings/test

string

required

string

required

The member to test. Must be verified in the guild.

number

required

The binding to test against.

boolean

string

A human-readable explanation, for example “User rank 12 is below minimum 50”.

number

The member’s rank in the group, when applicable.

{
  "status": "success",
  "code": 200,
  "message": "Binding test complete",
  "data": {
    "matches": false,
    "reason": "User rank 12 is below minimum 50",
    "user_rank": 12
  }
}

Validate a group binding config

Check a group rank configuration before saving it. This validates the group exists and the ranks are sane. It is group-rank specific.

POST /bindings/validate

number

required

number

0 to 255.

number

0 to 255, and at least min_rank.

{
  "status": "success",
  "code": 200,
  "message": "Binding configuration is valid",
  "data": {
    "valid": true,
    "group_name": "Acme Corp",
    "group_id": 1200769
  }
}

Developer API

Endpoints

Playground

Reference

Binding types

List bindings

Add a binding

Update a binding

Remove a binding

Test a binding against a user

Validate a group binding config

​Binding types

​List bindings

​Add a binding

​Update a binding

​Remove a binding

​Test a binding against a user

​Validate a group binding config

Binding types

List bindings

Add a binding

Update a binding

Remove a binding

Test a binding against a user

Validate a group binding config