POST
https://api.dev.bifrostgaming.com/v1/graphqlguildSetServerRotation
v1Set the map rotation for a game server. Replaces the entire rotation with the provided list.
Operation Type
Mutation
Rate Limit: 1 request per 60 seconds per server
Server rotation does not change frequently.
Important usage notes
- This replaces the entire rotation. Make sure to include all maps you want in the rotation.
Input Fields
| Field | Type | Required | Description |
|---|---|---|---|
serverId | ID! | Required | The unique identifier of the game server. |
rotation | Array! | Required | Array of map objects with mapName and gameMode. |
gameType | String | Optional | The game type identifier. |
Code Examples
curl -X POST https://api.dev.bifrostgaming.com/v1/graphql \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"query": "mutation ($serverId: ID!, $rotation: [MapRotationInput!]!, $gameType: String) { guildSetServerRotation(serverId: $serverId, rotation: $rotation, gameType: $gameType) { success message } }",
"variables": { "serverId": "YOUR_SERVER_ID", "rotation": [{ "mapName": "carentan_warfare", "gameMode": "Warfare" }, { "mapName": "stmereeglise_offensive_us", "gameMode": "Offensive" }], "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
- Open Postman and click Import (top-left)
- Drag and drop the downloaded
.jsonfile, 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": {
"guildSetServerRotation": {
"success": true,
"message": "Server rotation updated successfully"
}
}
}
