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

# Creates a team

`POST /teams`

You need `contracts.devTeam.edit` permission to access this resource

## Request body

- object
  - `data` object, required
    - `attributes` object, required
      - `name` string — A team name.
      - `docker_registry` object
        - `uri` string — Docker Registry URI
        - `credentials` union — Docker Registry credentials. If value is null - registry will be accessed anonymously
          - object
            - `authFile` string — Path of the authentication file
          - object
            - `registryToken` string — Bearer token for accessing the source registry
          - object
            - `username` string — Docker Registry username
            - `password` string — Docker Registry password
    - `relationships` object, required
      - `contract` object, required
        - `data` object, required
          - `id` string, required — An Id of the contract
          - `type` 'contract', required — A value must be contract

## Response `201`

Created

- object
  - `data` object, required
    - `id` string, required
    - `type` 'team', required
    - `links` object, required
      - `self` string, required
    - `attributes` object, required
      - `name` string, required
    - `relationships` object, required
      - `contract` object, required
        - `data` object, required
          - `id` string, required
          - `type` 'contract', required
        - `links` object, required
          - `self` string, required
      - `users` object, required
        - `data` object[], required
          - `id` string, required
          - `type` 'user', required
      - `components` object, required
        - `data` object[], required
          - `id` string, required
          - `type` 'component', required
  - `meta` object, required
  - `links` object, required
    - `self` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2.md) · [All operations](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/elastic-io-rest-api-documentation-v2/revisions/411f9f98c01e/schema)