---
title: "Request experiment assignments"
method: POST
path: "/sdk/v1/experiments/assignments"
tags: ["SDK Experiments (V1)"]
---

# Request experiment assignments

`POST /sdk/v1/experiments/assignments`

Requests deterministic experiment assignments for the given gameserver and/or its players. For player-targeted experiments returns a `playerIdsByGroupId` map; for server-targeted experiments returns the assigned `gameserverGroupId`. Pass `knownGroupIds` to suppress redundant group payloads, and `playerProperties` / `serverProperties` to drive property-based targeting. Returns `null` when no experiments are active.

## Headers

- `isstudio` union
  - boolean
  - 'true' | 'false'
- `project-id` integer
- `serverid` string, required

## Request body

- object
  - `playerIds` string[], required
  - `allowGameserverAssignment` boolean
  - `knownGroupIds` number[]
  - `serverProperties` object
  - `playerProperties` object

## Response `200`

Default Response

- union
  - object
    - `groups` object[]
      - `id` number, required
      - `endsAt` number
      - `groupName` string, required
      - `experimentName` string, required
      - `configs` object, required
        - `options` object, required
          - `privacy` array[], required
            - string[]
        - `variables` Schema0, required — unresolved $ref
    - `targetType` 'gameserver', required
    - `gameserverGroupId` number
  - object
    - `groups` object[]
      - `id` number, required
      - `endsAt` number
      - `groupName` string, required
      - `experimentName` string, required
      - `configs` object, required
        - `options` object, required
          - `privacy` array[], required
            - string[]
        - `variables` Schema0, required — unresolved $ref
    - `targetType` 'player', required
    - `playerIdsByGroupId` object, required
  - unknown

---

[API](https://skmtc.dev/gamebeast/apis/gamebeast-api.md) · [All operations](https://skmtc.dev/gamebeast/apis/gamebeast-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gamebeast/gamebeast-api/revisions/e9940594b0cc/schema)