Evaluate configuration with context
Evaluate a configuration with rich identity and context. Recommended equivalent of the evaluated GET when custom properties are non-trivial. Returns the merged configuration with experiment metadata. Supports knownHash for application-level 304 change detection.
Authorization
sdkApiKey SDK (public) key, prefixed gb_pk_ (older keys: sdk_). Send it as the authorization header value. Scoped to one project, so it is safe to ship in a game build.
In: header
Header Parameters
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.
1 <= lengthValue in
- "production"
- "development"
0 < value <= 9007199254740991Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/sdk/v2/configurations/evaluate" \ -H "Content-Type: application/json" \ -d '{ "configuration": "game-settings", "unit": { "type": "user", "distinctId": "69935436" } }'{ "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": []}Configurations
Fetch and evaluate remote configurations. Without identity headers, returns the base configuration with hash-based 304. With identity headers, evaluates active experiments, merges changesets, and returns per-unit content with experiment metadata (SDK API key).
Get or evaluate configuration GET
Next Page