---
title: "Update cohort"
method: PUT
path: "/experiments/{experimentId}/cohorts/{cohortId}"
tags: ["cohorts"]
---

# Update cohort

`PUT /experiments/{experimentId}/cohorts/{cohortId}`

Update an existing cohort's metadata and participant configuration.

**Partial updates:** Only provided fields are updated. Omit fields you don't want to change.

**Note:** The `variableMap` and `stageUnlockMap` cannot be modified via API - they are managed internally.

## Path parameters

- `experimentId` string, required
- `cohortId` string, required

## Request body

- object
  - `name` string — Updated cohort name
  - `description` string — Updated description
  - `participantConfig` CohortParticipantConfig — Configuration for participants within a cohort
    - `minParticipantsPerCohort` integer — Minimum number of participants required
    - `maxParticipantsPerCohort` integer — Maximum number of participants allowed
    - `includeAllStagesInProgressBar` boolean — Whether to show all stages in the progress bar
    - `enableParticipantStageReset` boolean — Whether participants can reset stages
    - `showStageDescriptions` boolean — Whether to show stage descriptions to participants

## Response `200`

Cohort updated successfully

- object
  - `updated` boolean
  - `id` string

## Other responses

- `400` — Bad request - Invalid input
- `401` — Unauthorized - Missing or invalid API key
- `403` — Forbidden - Insufficient permissions or browser access attempted
- `404` — Not found - Resource doesn't exist
- `429` — Too many requests - Rate limit exceeded

## Changes

- **2025-12-11** `c3b80417b1e2` — 1 info
  - endpoint added
- **2025-12-10** `427ac306a646` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/pair-code/apis/deliberate-lab-api/changes/experiments/:experimentId/cohorts/:cohortId/put.md)

---

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