Temp Ban Player — guildTempBanPlayer | Bifrost Developer Center

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

guildTempBanPlayer

Temporarily ban a player from the game server for a specified number of days.

Operation Type

Mutation

Rate Limit: 150 requests per 5 minutes per server

Bulk operations are supported within the rate limit window.

Input Fields

Field	Type	Required	Description
`serverId`	ID!	Required	The server ID.
`playerId`	String!	Required	Player's Steam ID.
`playerName`	String!	Required	Player's current in-game name.
`moderationActionId`	String!	Required	Action ID from guildGetModActions.
`reason`	String!	Required	Reason for the temporary ban.
`durationDays`	Int!	Required	Ban duration in days.
`moderatorName`	String	Optional	Name of the moderator issuing the ban.

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 GuildTempBanPlayer($input: GuildTempBanInput!) { guildTempBanPlayer(input: $input) { success message error timestamp } }",
    "variables": {
      "input": {
        "serverId": "YOUR_SERVER_ID",
        "playerId": "76561198000000000",
        "playerName": "PlayerName",
        "moderationActionId": "ACTION_ID",
        "reason": "Repeated rule violations",
        "durationDays": 7,
        "moderatorName": "AdminName"
      }
    }
  }'

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": {
    "guildTempBanPlayer": {
      "success": true,
      "message": "Player temporarily banned"
    }
  }
}

Error Responses

In partnership with

Brilliant game servers for communities large and small.

Get yours today!

A Shrapnelworks product