Set Dynamic Weather — guildSetDynamicWeather

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

guildSetDynamicWeather

Toggle dynamic weather on every map on the server that supports it. Mirrors the UCP Dynamic Weather setting — fans out one RCON command per supported map (e.g., maps with hasDynamicWeather=true in the Bifrost map catalog).

Operation Type

Mutation

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

Important usage notes

The mutation fans out one RCON SetDynamicWeatherEnabled command per supported map. The map count is included in the success message.
Maps that do not support dynamic weather are skipped automatically.

Input Fields

Field	Type	Required	Description
`serverId`	ID!	Required	Unique server identifier.
`enabled`	Boolean!	Required	Whether dynamic weather is enabled.

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

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": {
    "guildSetDynamicWeather": {
      "success": true,
      "message": "Dynamic weather updated to true across 12 map(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 including the number of maps updated.
`error`	String	Optional	Error code on failure.
`timestamp`	String	Required	ISO-8601 timestamp.

A Shrapnelworks product