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

guildWarnPlayer

v1

Issue a warning to a player on a game server. The warning message is displayed to the player in-game.

Operation Type

Mutation

Rate Limit: 150 requests per 5 minutes per server

Bulk operations are supported within the rate limit window.

Input Fields

FieldTypeRequiredDescription
serverIdID!RequiredThe server ID.
playerIdString!RequiredPlayer's Steam ID.
playerNameString!RequiredPlayer's current in-game name.
reasonString!RequiredWarning reason/message.
moderatorNameStringOptionalName of the moderator issuing the warning.
gameTypeStringOptionalGame type identifier (e.g. "HLL").

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 GuildWarnPlayer($input: GuildWarnInput!) { guildWarnPlayer(input: $input) { success message error timestamp } }",
    "variables": {
      "input": {
        "serverId": "YOUR_SERVER_ID",
        "playerId": "76561198000000000",
        "playerName": "PlayerName",
        "reason": "Please follow server rules",
        "moderatorName": "AdminName",
        "gameType": "HLL"
      }
    }
  }'

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
  1. Open Postman and click Import (top-left)
  2. Drag and drop the downloaded .json file, or click Upload Files and select it
  3. Click Import to confirm
  4. The collection appears in your sidebar — expand it and select the request
  5. In the Body tab, update the placeholder values (your-partner-id, etc.) with your actual credentials
  6. 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": {
    "guildWarnPlayer": {
      "success": true,
      "message": "Warning sent to player"
    }
  }
}

Error Responses

In partnership with

Brilliant game servers for communities large and small.

Get yours today!

Shrapnelworks Logo

A Shrapnelworks product