GAgamebeast
SDK Configurations (V2)

Get or evaluate configuration

Changed on

Returns a configuration for the calling SDK's application and environment. When identity headers (distinct-id, unit-type) are present, evaluates active experiments, persists assignments and exposure proxies, applies changesets, and returns the merged configuration with experiment metadata. Without identity headers, returns the unevaluated base configuration. Supply the SDK's stored hash or If-None-Match header for 304 change detection.

get/sdk/v2/configurations/

Request

  • Base URL
    https://api.gamebeast.gg
  • Auth
    API key in header authorization

Query parameters

configurationstring
hashstring

Headers

environment'production' | 'development'

Environment alias. Defaults to development when omitted; studio is accepted as a synonym for it. Any alias outside the calling key's environment scope is rejected with 403.

project-idinteger
distinct-idstring
unit-type'user' | 'server'
evaluation-contextstring

Response

Default Response

hashstring required
configurationIdnumber required
namestring nullable required
configurationunknown required
updatedAtstring date-time required
requiredPropertiesstring[] required

Example response

{
  "hash": "9f2c4e1ab7d0c3e58f6a2b1d4c7e9f0a3b5d8c1e2f4a6b8d0c2e4f6a8b0d2c4e",
  "configurationId": 12,
  "name": "Game Settings",
  "configuration": {
    "PlayerSpeed": 16,
    "NPCs": {
      "Spider": {
        "Health": 120
      }
    }
  },
  "privacy": [],
  "updatedAt": "2026-09-24T17:00:00.000Z",
  "experiments": [
    {
      "experimentId": 7,
      "groupId": 21,
      "assignmentVersion": 1,
      "source": "weightedHash",
      "exposureProxyRecorded": true
    }
  ],
  "requiredProperties": []
}

Changes

  • 8541dcfed596Revision changes
    • breaking

      the response property became nullable for the status

    • breaking

      the response's property type changed from no type to string null for status

    • info

      for the header request parameter project-id, the exclusiveMinimum was decreased from true to 0.00

    • info

      added the media type application/json for the response with the status

    • info

      removed subschema #1 subschema #2 from the response property anyOf list for the response status

    • info

      the response's property pattern was changed from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status

  • 6038ecabdc8bRevision changes
    • warning

      added the new RATE_LIMITED enum value to the response property for the response status

    • warning

      added the new RATE_LIMITED enum value to the response property for the response status

    • warning

      added the new RATE_LIMITED enum value to the response property for the response status

    • warning

      added the new RATE_LIMITED enum value to the response property for the response status

    • warning

      added the new UNAUTHORIZED enum value to the response property for the response status

    • warning

      added the new UNAUTHORIZED enum value to the response property for the response status

    • warning

      added the new UNAUTHORIZED enum value to the response property for the response status

    • warning

      added the new UNAUTHORIZED enum value to the response property for the response status

    • info

      api operation id getConfiguration was added