---
title: "POST /api/v1/config/teams"
method: POST
path: "/api/v1/config/teams"
tags: ["Team"]
---

# POST /api/v1/config/teams

`POST /api/v1/config/teams`

## Request body

- Configv1CreateTeamRequest
  - `dry_run` boolean — If `true`, validates the specified configuration without creating the Team. If the specified configuration is valid, the endpoint returns a partial response without the Team. If the specified configuration is invalid, the endpoint returns an error.
  - `team` Configv1Team
    - `created_at` string, date-time — Timestamp of when the Team was created. Cannot be set by clients.
    - `description` string — Optional. Short description of the team.
    - `name` string, required — The name of the Team. You can modify this value after the Team is created.
    - `slug` string — The unique identifier of the Team. If a `slug` isn't provided, one is generated based on the `name` field. You can't modify this field after the Team is created.
    - `updated_at` string, date-time — Timestamp of when the Team was last updated. Cannot be set by clients.
    - `user_emails` string[] — Unordered set of emails whose users are members of this team.

## Response `200`

A successful response containing the created Team.

- Configv1CreateTeamResponse
  - `team` Configv1Team
    - `created_at` string, date-time — Timestamp of when the Team was created. Cannot be set by clients.
    - `description` string — Optional. Short description of the team.
    - `name` string, required — The name of the Team. You can modify this value after the Team is created.
    - `slug` string — The unique identifier of the Team. If a `slug` isn't provided, one is generated based on the `name` field. You can't modify this field after the Team is created.
    - `updated_at` string, date-time — Timestamp of when the Team was last updated. Cannot be set by clients.
    - `user_emails` string[] — Unordered set of emails whose users are members of this team.

## Other responses

- `400` — Cannot create the Team because the request is invalid.
- `409` — Cannot create the Team because there is a conflict with an existing Team.
- `500` — An unexpected error response.
- `default` — An undefined error response.

---

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