Set Idle Kick Time — guildSetIdleKickTime

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

guildSetIdleKickTime

Update the minutes of inactivity before a player is auto-kicked. 0 disables idle kicking. Mirrors the UCP Idle Kick Time setting.

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". Valid range: 0-30.
Setting minutes to 0 disables idle kicking entirely on this server.

Input Fields

Field	Type	Required	Description
`serverId`	ID!	Required	Unique server identifier.
`minutes`	Int!	Required	Idle threshold in minutes. 0 disables. Range: 0-30.

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

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": {
    "guildSetIdleKickTime": {
      "success": true,
      "message": "Idle kick time updated to 5 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.
`timestamp`	String	Required	ISO-8601 timestamp.

A Shrapnelworks product