---
title: "Create a new workgroup./>."
method: POST
path: "/api/v{version}/workgroup"
tags: ["Workgroup"]
---

# Create a new workgroup./>.

`POST /api/v{version}/workgroup`

## Path parameters

- `version` string, required

## Request body

- Workgroup — Represents a workgroup entity in the database.
  - `id` integer, required
  - `name` string, required — Gets or sets the name of the workgroup.
  - `createdAt` string, date-time, nullable — Gets or sets the BDMS.Models.Workgroup created date.
  - `disabledAt` string, date-time, nullable — Gets or sets the BDMS.Models.Workgroup disabled date.
  - `isDisabled` boolean — Gets the value whether the BDMS.Models.Workgroup is disabled or not.
  - `settings` string, nullable — Gets or sets the Settings for the BDMS.Models.Workgroup.
  - `boreholeCount` integer — Number of boreholes in the workgroup.

## Response `200`

The workgroup was created successfully.

## Other responses

- `400` — The workgroup could not be created due to invalid input.
- `401` — The current user is not authorized to create workgroups.
- `500` — The server encountered an unexpected condition that prevented it from fulfilling the request.

## Changes

- **2026-06-22** `4b5d5e7caaa2` — 6 breaking
  - the request property `name` became required (media type: application/json)
  - the request property `name` became required (media type: text/json)
  - the request property `name` became required (media type: application/*+json)
  - the `name` request property's minLength was increased from `0` to `1` (media type: application/json)
  - …2 more
- **2026-06-04** `237c19a934a8` — 3 breaking
  - the request property `id` became required (media type: application/json)
  - the request property `id` became required (media type: text/json)
  - the request property `id` became required (media type: application/*+json)
  - …this revision’s changelog is incomplete
- **2026-05-11** `5e166dd6e186` — 3 breaking
  - the request property `id` became required (media type: application/json)
  - the request property `id` became required (media type: text/json)
  - the request property `id` became required (media type: application/*+json)
  - …this revision’s changelog is incomplete

[Change history](https://skmtc.dev/geoadmin/apis/boreholes-rest-api-v2/changes/api/v:version/workgroup/post.md)

---

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