https://api.dev.bifrostgaming.com/v1/graphqlguildSetNextMap
v1Set the next map to play after the current match ends. Designed for Discord bot votemap integration — your bot runs map votes in Discord, then calls this endpoint with the winning map. Requires votemap to be enabled with mode set to "Discord via API" in the Bifrost control panel. The server rotation is temporarily set to only the winning map, and automatically restored after the map plays.
Operation Type
Mutation
Rate Limit: 1 per active match (enforced by pending state)
Only one next-map can be set per match. Once set, subsequent calls are rejected until the map changes and the rotation is restored.
Important usage notes
- This endpoint must be called while there are more than 5 minutes remaining in the current match. Calls made with 5 minutes or less remaining will be rejected — the map transition is too close to safely change the rotation.
- The mapRconName must be a map that exists in the server's currently applied map rotation. Use guildGetServerRotation to retrieve the list of available maps and their RCON names. If the map is not in the active rotation, the call will be rejected.
- Only one next-map can be pending at a time. Once a map has been set, further calls are rejected until the current match ends, the chosen map plays, and the original rotation is automatically restored by Bifrost.
- Votemap must be enabled and set to "Discord via API" mode in the Bifrost control panel (Map Management > Votemap). If the mode is set to "Bifrost Automated", this endpoint will return an error — both systems cannot run simultaneously.
Input Fields
| Field | Type | Required | Description |
|---|---|---|---|
serverId | ID! | Required | The unique identifier of the game server. |
mapRconName | String! | Required | The RCON name of the winning map (must be in the server's current rotation). Use guildGetServerRotation to see available maps. |
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 ($input: GuildSetNextMapInput!) { guildSetNextMap(input: $input) { success message error timestamp } }",
"variables": { "input": { "serverId": "YOUR_SERVER_ID", "mapRconName": "carentan_warfare" } }
}'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": {
"guildSetNextMap": {
"success": true,
"message": "Next map set to carentan_warfare. It will play after the current match ends.",
"error": null,
"timestamp": "2026-03-02T12:00:00.000Z"
}
}
}
