---
title: "Set manual assignment"
method: POST
path: "/application/{applicationId}/v2/experiments/{experimentId}/assignments"
tags: ["Experiments (V2)"]
---

# Set manual assignment

`POST /application/{applicationId}/v2/experiments/{experimentId}/assignments`

Set or clear a manual override for a unit's experiment assignment. Pass groupId to assign, or null to clear the override and revert to automatic.

## Path parameters

- `applicationId` integer, required
- `experimentId` integer, required

## Headers

- `environment_id` number, required

## Request body

- object
  - `unitType` 'user' | 'server', required
  - `distinctId` string, required
  - `groupId` union, required
    - integer
    - unknown
  - `ignoreFilters` boolean
  - `reason` union
    - string
    - unknown
  - `idempotencyKey` string

## Response `200`

Default Response

- object
  - `assignment` object, required
    - `experimentId` integer, required
    - `unitType` 'user' | 'server', required
    - `distinctId` string, required
    - `automaticGroupId` union, required
      - integer
      - unknown
    - `automaticSource` union, required
      - 'weightedHash' | 'roundRobin'
      - unknown
    - `automaticAssignedAt` union, required
      - string, date-time
      - unknown
    - `overrideGroupId` union, required
      - integer
      - unknown
    - `overrideSetAt` union, required
      - string, date-time
      - unknown
    - `overrideSetBy` union, required
      - string, uuid
      - unknown
    - `overrideReason` union, required
      - string
      - unknown
    - `status` 'active' | 'unenrolled', required
    - `effectiveGroupId` union, required
      - integer
      - unknown
    - `effectiveSource` union, required
      - 'weightedHash' | 'roundRobin' | 'manual'
      - unknown
    - `version` integer, required
    - `statusChangedAt` string, date-time, required
    - `statusChangedBy` union, required
      - string, uuid
      - unknown
    - `statusReason` union, required
      - string
      - unknown
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `replayed` boolean, required

---

[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/801fbad9d8d0/schema)