---
title: "Changes to Create Team"
method: POST
path: "/v3/portals/{portalId}/teams"
---

# Changes to Create Team

`POST /v3/portals/{portalId}/teams`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 70 revisions.

- **2026-10-23** `30af8b28f6ef`: 1 breaking, 2 warning
- **2026-09-30** `f530bf400198`: 3 warning
- **2026-09-25** `4a02153f2e60`: 3 breaking, 26 info
- **2026-08-26** `72502a676a92`: 2 breaking, 1 warning
- **2026-08-04** `06734a9c491f`: 5 info
- **2026-03-27** `aad4daa45eee`: 2 info
- **2025-10-29** `19e869275e28`: 1 warning
- **2025-08-22** `96118a9cd7f4`: 1 info

## Changes

- **2026-10-23** `30af8b28f6ef`: 1 breaking, 2 warning
  - added `#/components/schemas/InvalidParameterMinimumTime, #/components/schemas/InvalidParameterMaximumTime` to the `invalid_parameters/items/` response property `oneOf` list for the response status `400`
  - added the new `key_invalid` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the new `unique` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2026-09-30** `f530bf400198`: 3 warning
  - added the new `400.00` enum value to the `status` response property for the response status `400`
  - added the new `403.00` enum value to the `status` response property for the response status `403`
  - added the new `404.00` enum value to the `status` response property for the response status `404`
- **2026-09-25** `4a02153f2e60`: 3 breaking, 26 info
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `404`
  - added the new optional request property `konnect_managed`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `400`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `403`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `404`
  - added the optional property `konnect_managed` to the response with the `201` status
  - added the optional property `type` to the response with the `400` status
  - added the optional property `type` to the response with the `403` status
  - added the optional property `type` to the response with the `404` status
  - the response property `detail` became required for the status `401`
  - the response property `instance` became required for the status `401`
  - the response property `status` became required for the status `401`
  - the response property `title` became required for the status `401`
  - added the required property `detail` to the response with the `400` status
  - added the required property `detail` to the response with the `403` status
  - added the required property `detail` to the response with the `404` status
  - added the required property `instance` to the response with the `400` status
  - added the required property `instance` to the response with the `403` status
  - added the required property `instance` to the response with the `404` status
  - added the required property `invalid_parameters` to the response with the `400` status
  - added the required property `status` to the response with the `400` status
  - added the required property `status` to the response with the `403` status
  - added the required property `status` to the response with the `404` status
  - added the required property `title` to the response with the `400` status
  - added the required property `title` to the response with the `403` status
  - added the required property `title` to the response with the `404` status
- **2026-08-26** `72502a676a92`: 2 breaking, 1 warning
  - the `description` request property's minLength was increased from `0` to `1`
  - the `name` request property's minLength was increased from `0` to `1`
  - the `name` request property's maxLength was set to `250`
- **2026-08-04** `06734a9c491f`: 5 info
  - the response property `created_at` became required for the status `201`
  - the response property `description` became required for the status `201`
  - the response property `id` became required for the status `201`
  - the response property `name` became required for the status `201`
  - the response property `updated_at` became required for the status `201`
- **2026-03-27** `aad4daa45eee`: 2 info
  - added the new optional request property `can_own_applications`
  - added the optional property `can_own_applications` to the response with the `201` status
- **2025-10-29** `19e869275e28`: 1 warning
  - added the new `type` enum value to the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2025-08-22** `96118a9cd7f4`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api/docs/v3/portals/:portalId/teams/post.md) - [API](https://skmtc.dev/kong/apis/konnect-api.md) - [Page](https://skmtc.dev/kong/apis/konnect-api/changes/v3/portals/:portalId/teams/post)