Grant Admin Cam — guildGrantAdminCam | Bifrost Developer Center

POSThttps://api.dev.bifrostgaming.com/v1/graphql

guildGrantAdminCam

Grant a player admin cam access on a server by adding them to the server's "Spectator" admin group. Currently supported on HLL only. Fire-and-forget — success means the command was queued for delivery; the in-game effect typically lands within a couple of seconds.

Operation Type

Mutation

Rate Limit: 150 requests per 5 minutes per server

Bulk operations are supported within the rate limit window.

Important usage notes

Adds the player to the **Spectator** admin group, which is the HLL built-in group that grants admin-cam access. The group name is fixed by the API and not configurable.
If the player is already in a different admin group, this call will MOVE them to Spectator (the server-side AddAdmin command is not additive).
Returns `error: "UNSUPPORTED_GAMETYPE"` if the server's game type does not have the AddAdmin RCON command registered (HLL is the only supported game type at this time).
The action is logged to the guild's moderator action history as `GRANT_ADMIN_CAM` and appears alongside manual admin actions in the audit views.

Input Fields

Field	Type	Required	Description
`serverId`	ID!	Required	The server ID.
`playerId`	String!	Required	Player's platform ID (Steam ID, EOS ID, or T17 ID).
`playerName`	String!	Required	Player's in-game name. Stored as the comment on the server-side admin entry so audit listings remain human-readable.

Code Examples

curl -X POST https://api.dev.bifrostgaming.com/v1/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "query": "mutation GuildGrantAdminCam($input: GuildGrantAdminCamInput!) { guildGrantAdminCam(input: $input) { success message error timestamp } }",
    "variables": {
      "input": {
        "serverId": "YOUR_SERVER_ID",
        "playerId": "76561198000000000",
        "playerName": "PlayerName"
      }
    }
  }'

Postman Collection

Download a ready-to-use Postman collection for this endpoint. Import it into Postman to start testing immediately.

How to import into Postman

Open Postman and click Import (top-left)
Drag and drop the downloaded .json file, or click Upload Files and select it
Click Import to confirm
The collection appears in your sidebar — expand it and select the request
In the Body tab, update the placeholder values (your-partner-id, etc.) with your actual credentials
Click Send

The collection uses Postman's GraphQL body type, which provides syntax highlighting and variable editing. Make sure your Postman version is 7.2+ for GraphQL support.

Success Response200

{
  "data": {
    "guildGrantAdminCam": {
      "success": true,
      "message": "PlayerName granted admin cam (Spectator group)",
      "error": null,
      "timestamp": "2026-05-18T19:30:18.054Z"
    }
  }
}

Error Responses

A Shrapnelworks product