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

# Create a team

`POST /v1/teams`

## Request body

- TeamCreate
  - `name` string, required
  - `description` string, nullable
  - `purpose` string, nullable
  - `mode` 'supervisor' | 'swarm'
  - `fallback_member_id` string, uuid, required
  - `initial_member_id` string, uuid, nullable
  - `swarm_domain_hint` string, nullable
  - `swarm_max_hops` integer, nullable
  - `router_config_id` string, uuid, nullable
  - `router_model_settings` ModelChainEntry
    - `model` string, required
    - `config` ModelConfig
      - `temperature` number, nullable
      - `max_tokens` integer, nullable
      - `top_p` number, nullable
      - `stop_sequences` string[], nullable
      - `reasoning_effort` 'none' | 'low' | 'medium' | 'high' | 'xhigh', nullable
      - `request_timeout_ms` integer, nullable
      - `thinking_budget` integer, nullable
  - `members` TeamMemberCreate[], nullable
    - `assistant_id` string, uuid, required
    - `assistant_revision_id` string, uuid, nullable
    - `router_name` string, nullable
    - `router_description` string, nullable
    - `examples` string[], nullable
    - `model_settings` ModelChainEntry
      - `model` string, required
      - `config` ModelConfig
        - `temperature` number, nullable
        - `max_tokens` integer, nullable
        - `top_p` number, nullable
        - `stop_sequences` string[], nullable
        - `reasoning_effort` 'none' | 'low' | 'medium' | 'high' | 'xhigh', nullable
        - `request_timeout_ms` integer, nullable
        - `thinking_budget` integer, nullable
    - `position` integer
    - `enabled` boolean
  - `metadata` object, nullable

## Response `201`

Successful Response

- TeamResponse
  - `id` string, uuid, required
  - `organization_id` string, uuid, required
  - `name` string, required
  - `description` string, nullable
  - `active_revision_id` string, uuid, nullable
  - `active_revision` TeamRevisionResponse
    - `id` string, uuid, required
    - `team_id` string, uuid, required
    - `name` string, required
    - `description` string, nullable
    - `purpose` string, nullable
    - `mode` string, required
    - `fallback_member_id` string, uuid, required
    - `initial_member_id` string, uuid, nullable
    - `swarm_domain_hint` string, nullable
    - `swarm_max_hops` integer, required
    - `router_config_id` string, uuid, nullable
    - `router_model_settings` ModelChainEntry
      - `model` string, required
      - `config` ModelConfig
        - `temperature` number, nullable
        - `max_tokens` integer, nullable
        - `top_p` number, nullable
        - `stop_sequences` string[], nullable
        - `reasoning_effort` 'none' | 'low' | 'medium' | 'high' | 'xhigh', nullable
        - `request_timeout_ms` integer, nullable
        - `thinking_budget` integer, nullable
    - `members` TeamMemberResponse[]
      - `id` string, uuid, required
      - `assistant_id` string, uuid, required
      - `assistant_name` string, required
      - `assistant_revision_id` string, uuid, nullable
      - `router_name` string, nullable
      - `router_description` string, nullable
      - `examples` string[]
      - `model_settings` ModelChainEntry
        - `model` string, required
        - `config` ModelConfig
          - `temperature` number, nullable
          - `max_tokens` integer, nullable
          - `top_p` number, nullable
          - `stop_sequences` string[], nullable
          - `reasoning_effort` 'none' | 'low' | 'medium' | 'high' | 'xhigh', nullable
          - `request_timeout_ms` integer, nullable
          - `thinking_budget` integer, nullable
      - `position` integer, required
      - `enabled` boolean, required
      - `created_at` string, date-time, required
    - `created_by` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `metadata` object
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/versions/888bdd5c076e/schema)