Set Team Switch Cooldown — guildSetTeamSwitchCooldown

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

guildSetTeamSwitchCooldown

Update the per-player cooldown between team switches on a server. Mirrors the UCP control panel's Team Switch Cooldown setting — same DB write and same RCON publish.

Operation Type

Mutation

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

Important usage notes

Out-of-range values return error: "INVALID_INPUT" with a descriptive message. Valid range: 0-120.
Requires an existing Server Basics config on the target server — create one in the Bifrost control panel first if absent.

Input Fields

Field	Type	Required	Description
`serverId`	ID!	Required	Unique server identifier.
`minutes`	Int!	Required	Cooldown duration in minutes. Range: 0-120.

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: GuildSetTeamSwitchCooldownInput!) { guildSetTeamSwitchCooldown(input: $input) { success message error timestamp } }",
    "variables": { "input": { "serverId": "YOUR_SERVER_ID", "minutes": 15 } }
  }'

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": {
    "guildSetTeamSwitchCooldown": {
      "success": true,
      "message": "Team switch cooldown updated to 15 minute(s).",
      "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 (INVALID_INPUT, CONFIG_NOT_FOUND, etc.).
`timestamp`	String	Required	ISO-8601 timestamp of the mutation.

A Shrapnelworks product