---
title: "POST /teams/"
method: POST
path: "/teams/"
tags: ["teams"]
---

# POST /teams/

`POST /teams/`

Create a new team

## Request body

- TeamCreate
  - `name` string, required — The name of this resource
  - `description` string — The team description.
  - `organization_id` integer, required

## Response `201`

Return the new team.

- Team
  - `id` integer, required
  - `name` string, required — The name of this resource
  - `description` string — The team description.
  - `organization_id` integer, required — The organization of this team.
  - `resource` object, required
  - `created` string, date-time, required — The date/time this resource was created
  - `created_by` integer, nullable, required — The user who created this resource
  - `modified` string, date-time, required — The date/time this resource was created
  - `modified_by` integer, nullable, required — The user who last modified this resource

## Other responses

- `403` — Create is prohibited

## Changes

- **2026-07-17** `c04fc5f09692` — 6 breaking, 1 info
  - the request property `organization_id` became not nullable (media type: application/json)
  - the request property `organization_id` became not nullable (media type: application/x-www-form-urlencoded)
  - the request property `organization_id` became not nullable (media type: multipart/form-data)
  - the request property `organization_id` became required (media type: application/json)
  - …3 more
- **2024-04-29** `feeac1db5ade` — 6 info
  - the request property `organization_id` became nullable (media type: application/json)
  - the request property `organization_id` became nullable (media type: application/x-www-form-urlencoded)
  - the request property `organization_id` became nullable (media type: multipart/form-data)
  - the request property `organization_id` became optional (media type: application/json)
  - …2 more
- **2024-04-23** `cbf68ddd9760` — 1 info
  - endpoint added
- **2023-04-25** `62d33b790834` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ansible/apis/event-driven-ansible-api/changes/teams/post.md)

---

[API](https://skmtc.dev/ansible/apis/event-driven-ansible-api.md) · [All operations](https://skmtc.dev/ansible/apis/event-driven-ansible-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ansible/event-driven-ansible-api/revisions/c04fc5f09692/schema)