---
title: "Create the team."
method: POST
path: "/users/{login_name}/teams"
tags: ["team"]
---

# Create the team.

`POST /users/{login_name}/teams`

Create the team.

## Path parameters

- `login_name` string, required

## Request body

- TeamCreateRequest
  - `spec` TeamSpec
    - `api_key` string
    - `avatar_url` string — AvatarUrl is the avatar url of the team.
    - `email` string — Email is the email of the team.
    - `id` string — ID holds the unique identifier of the team.
    - `members` TeamMember[]
      - `email` string
      - `id` string
      - `name` string
      - `role` 'owner' | 'member' | 'pending'
    - `name` string — Name is the name of the team.

## Response `201`

Created

- TeamSpec
  - `api_key` string
  - `avatar_url` string — AvatarUrl is the avatar url of the team.
  - `email` string — Email is the email of the team.
  - `id` string — ID holds the unique identifier of the team.
  - `members` TeamMember[]
    - `email` string
    - `id` string
    - `name` string
    - `role` 'owner' | 'member' | 'pending'
  - `name` string — Name is the name of the team.

---

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