---
title: "Changes to POST /v1/departments"
method: POST
path: "/v1/departments"
---

# Changes to POST /v1/departments

`POST /v1/departments`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 20 revisions.

- **2026-03-19** `a896c17cf988` — 5 breaking, 2 info
- **2026-03-13** `6cfbdf910b80` — 1 warning
- **2026-03-09** `768d9cb8d8d9` — 2 breaking, 3 info
- **2026-03-09** `787281d7e9a2` — 1 info

## Changes

- **2026-03-19** `a896c17cf988` — 5 breaking, 2 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `403`
  - removed the required property `_tag` from the response with the `403` status
  - removed the required property `message` from the response with the `403` status
  - removed the required property `requiredPermissions` from the response with the `403` status
  - removed the success response with the status `200`
  - added `#/components/schemas/MissingRequiredPermissions, #/components/schemas/ApiNotEnabled` to the response body `anyOf` list for the response status `403`
  - added the success response with the status `201`
- **2026-03-13** `6cfbdf910b80` — 1 warning
  - added the new `company:workplaces` enum value to the `requiredPermissions/items/scope` response property for the response status `403`
- **2026-03-09** `768d9cb8d8d9` — 2 breaking, 3 info
  - the `requiredPermissions/items/` response property's minItems was decreased from `2` to `0` for the response status `403`
  - the `requiredPermissions/items/` response's property type/format changed from `array`/`` to `object`/`` for status `403`
  - removed `subschema #1, subschema #2` from the `requiredPermissions/items/` response property 'prefixItems' list for the response status `403`
  - added the required property `requiredPermissions/items/level` to the response with the `403` status
  - added the required property `requiredPermissions/items/scope` to the response with the `403` status
- **2026-03-09** `787281d7e9a2` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/teamwarp/apis/warp-api/docs/v1/departments/post.md) · [API](https://skmtc.dev/teamwarp/apis/warp-api.md) · [Page](https://skmtc.dev/teamwarp/apis/warp-api/changes/v1/departments/post)