Bulk resolve experiment assignments

Changed on Oct 17, 2026

Resolve experiment assignments for up to 250 units sharing the same unit type. Creates and persists assignments as needed (weighted hash or round-robin), identically to the single-unit endpoints. Designed for server-side SDKs (e.g. Roblox) that batch-assign players rather than polling per-user. Returns a map of distinctId → assignment array; IDs with no active assignments appear with an empty array. Fails the whole batch with 503 if any assignment or exposure record cannot be durably written.

Supply units with an optional per-unit context, plus an optional sharedContext carrying facts the whole batch shares — the unit's own values win per key. The older distinctIds array is still accepted but resolves without context, so targeted experiments will not match those units.

post/sdk/v2/experiments/assignments/bulk

Request

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

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

Request body

Response

Default Response

assignmentsobject required

Changes

Oct 17, 20262c7af0fa7de9 Revision changes
- info
  added the new optional request property //
- info
  added the new optional request property ////
Sep 26, 20268541dcfed596 Revision changes
- breaking
  request property ///// was restricted to a list of enum values
- breaking
  request property /////// was restricted to a list of enum values
- breaking
  the request property ///// became not nullable
- breaking
  the request property ///// became not nullable
- breaking
  the request property ///// became not nullable
- breaking
  the request property ///// became not nullable
- breaking
  the request property ///// became not nullable
- breaking
  the request property ///// became not nullable
- breaking
  the request property ///// became not nullable
- breaking
  the request property /////// became not nullable
- breaking
  the request property /////// became not nullable
- breaking
  the request property /////// became not nullable
- breaking
  the request property /////// became not nullable
- breaking
  the request property /////// became not nullable
- breaking
  the request property /////// became not nullable
- breaking
  the request property /////// became not nullable
- breaking
  the ///// request property type changed from null to string null
- breaking
  the ///// request property type changed from no type to string null
- breaking
  the ///// request property type changed from no type to string null
- breaking
  the ///// request property type changed from no type to string null
- breaking
  the ///// request property type changed from no type to string null
- breaking
  the ///// request property type changed from no type to string null
- breaking
  the ///// request property type changed from no type to string null
- breaking
  the ///// request property type changed from no type to string null
- breaking
  the /////// request property type changed from null to string null
- breaking
  the /////// request property type changed from no type to string null
- breaking
  the /////// request property type changed from no type to string null
- breaking
  the /////// request property type changed from no type to string null
- breaking
  the /////// request property type changed from no type to string null
- breaking
  the /////// request property type changed from no type to string null
- breaking
  the /////// request property type changed from no type to string null
- breaking
  the /////// request property type changed from no type to string null
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- info
  for the header request parameter project-id, the exclusiveMinimum was decreased from true to 0.00
- info
  added the new undefined enum value to the request property /////
- info
  added the new undefined enum value to the request property ///////
- info
  response property assignments/additionalProperties/items/automaticGroupId list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property assignments/additionalProperties/items/overrideGroupId list-of-types was narrowed by removing types null from media type application/json of response 200

Operation history (3 revisions)