---
title: "POST /v1/organizations/{organizationId}/projects/{projectId}/cohorts"
method: POST
path: "/v1/organizations/{organizationId}/projects/{projectId}/cohorts"
tags: ["Cohorts"]
---

# POST /v1/organizations/{organizationId}/projects/{projectId}/cohorts

`POST /v1/organizations/{organizationId}/projects/{projectId}/cohorts`

## Request

- Base URL: `https://api.golioth.io`
- URL: `https://api.golioth.io/v1/organizations/{organizationId}/projects/{projectId}/cohorts`
- Auth: API key in header `x-api-key` and API key in header `Authorization`

## Path parameters

- `organizationId` string, required
- `projectId` string, required

## Request body

- GoliothCohortsCreateBody
  - `name` string

## Response `200`

A successful response.

- GoliothCreateCohortResponse
  - `data` GoliothCohort
    - `activeDeploymentId` string
    - `cohortId` string
    - `createdAt` string, date-time
    - `deviceCount` integer
    - `name` string
    - `updatedAt` string, date-time

## Other responses

- `default`: An unexpected error response.

## Changes

- **2024-11-06** `dbbf7fd3a346`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/golioth/apis/golioth-api/changes/v1/organizations/:organizationId/projects/:projectId/cohorts/post.md)

---

[API](https://skmtc.dev/golioth/apis/golioth-api.md) - [All operations](https://skmtc.dev/golioth/apis/golioth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/golioth/apis/golioth-api/revisions/47c98ae69a55?raw)