Set Auto Balance — guildSetAutoBalance | Bifrost Developer Center

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

guildSetAutoBalance

Toggle auto-balance and set the player-count delta that triggers a forced switch. Mirrors the UCP Auto Balance section — both fields are written and published in one call.

Operation Type

Mutation

Rate Limit: No explicit rate limit; reasonable use enforced by OAuth client throttling.

Important usage notes

Both enabled and threshold are required. To toggle one without affecting the other, supply the current value for the field you are not changing.
threshold out of range returns error: "INVALID_INPUT". Valid range: 1-20.

Input Fields

Field	Type	Required	Description
`serverId`	ID!	Required	Unique server identifier.
`enabled`	Boolean!	Required	Whether auto-balance is active on this server.
`threshold`	Int!	Required	Player-count delta between teams that triggers a forced switch. Range: 1-20.

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: GuildSetAutoBalanceInput!) { guildSetAutoBalance(input: $input) { success message error timestamp } }",
    "variables": { "input": { "serverId": "YOUR_SERVER_ID", "enabled": true, "threshold": 3 } }
  }'

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": {
    "guildSetAutoBalance": {
      "success": true,
      "message": "Auto-balance updated: enabled=true, threshold=3.",
      "error": null,
      "timestamp": "2026-05-20T15:00:00.000Z"
    }
  }
}

Error Responses

Response Fields

Field	Type	Required	Description
`success`	Boolean	Required	Whether the update succeeded.
`message`	String	Required	Human-readable result.
`error`	String	Optional	Error code on failure.
`timestamp`	String	Required	ISO-8601 timestamp.

A Shrapnelworks product