Skip to main content
These endpoints power staff activity tracking and the Server Manager command queue. They are the protocol the Adonis plugin and the standalone Technified Admin speak. You only need them if you are building a custom in-game admin system. If you use the official plugin, it handles all of this for you.
Unlike the moderation endpoints, these routes use camelCase field names (guildId, robloxId). Match the examples exactly.

Staff permissions

Resolve a Roblox user’s staff permission level so your admin system can grant the right access in-game.
GET /guilds/:guildId/staff/roblox/:robloxId/permissions
guildId
string
required
robloxId
number
required

Game registration

Register the running game with Technified on startup. This is what makes the game appear under connected games in the dashboard.
POST /roblox/games/register
Body
{
  "guildId": "123456789012345678",
  "placeId": "987654321",
  "universeId": "111222333",
  "gameName": "My Game",
  "creatorId": "1",
  "metadata": {
    "source": "adonis-plugin",
    "pluginVersion": "2.0.0",
    "jobId": "abc123-..."
  }
}

Session tracking

Report when a staff member starts and stops playing, so their hours show up in Staff Activity.
POST /staff/roblox/session/start
Body
{
  "guildId": "123456789012345678",
  "robloxId": "261",
  "robloxUsername": "Shedletsky",
  "placeId": "987654321",
  "universeId": "111222333",
  "gameName": "My Game"
}

Action logging

Log a moderation or admin command so it appears in the audit logs and counts toward performance scoring.
POST /staff/roblox/action
Body
{
  "guildId": "123456789012345678",
  "actorRobloxId": "261",
  "actorUsername": "Shedletsky",
  "actionType": "ban",
  "actionCategory": "moderation",
  "targetRobloxId": "156",
  "targetUsername": "Telamon",
  "placeId": "987654321",
  "universeId": "111222333",
  "details": {
    "reason": "Exploiting",
    "rawCommand": ":ban Telamon Exploiting",
    "source": "adonis"
  }
}
actionCategory is moderation or admin. See the Adonis plugin features for the full command list.

Server Manager queue

The live server control endpoints (heartbeat, poll commands, acknowledge) are also part of this protocol and use the same guild API key. They have their own page.

Server Manager

Heartbeat a server, poll for queued commands, and acknowledge results.