---
title: "Set the boards' team setup"
method: POST
path: "/teams/setup"
tags: ["Team"]
---

# Set the boards' team setup

`POST /teams/setup`

## Request

- Base URL: `https://api.gleap.io/v3`
- URL: `https://api.gleap.io/v3/teams/setup`
- Auth: HTTP bearer

Turn team routing on or off, set the default team and each board's team (`default`, `team` with
a team id, or `nobody`). `assignOpenUnowned` also gives today's open tickets nobody owns to their
board's team. Off: assignment works exactly as before; the boards keep their picks.

## Headers

- `project` string, required

## Request body

- TeamSetupDto: POST /teams/setup: team routing on or off, the default team, and each board's team.
  - `enabled` boolean
  - `defaultTeam` string, nullable
  - `boards` object[]: Each board's team (`assignTo`) and, Kai re-release, whether Kai Support's escalated stage works its tickets ("Kai investigates here": the board's team takes Kai Support as its first agent there). Either field may come alone.
    - `kaiInvestigates` boolean
    - `assignTo` object
      - `team` string, nullable
      - `mode` 'default' | 'team' | 'nobody', required
    - `type` string, required
  - `escalationBoard` string, nullable: Where an escalated conversation lands (a board type; bugs always land on Bugs). Null: Conversations.
  - `escalationLimits` object: Kai Support's escalated stage: escalated tickets a day, and a monthly budget in USD cents (null: none).
    - `monthlyBudgetMinor` number, double, nullable
    - `dailyCap` number, double
  - `assignOpenUnowned` boolean: Also give today's open tickets nobody owns to their board's team (only with `enabled: true`).

## Response `200`

Ok

- object
  - `escalationBoard` string, required
  - `escalationLimits` object, required
    - `reached` unknown, required
    - `today` unknown, required
    - `monthlyBudgetMinor` unknown, required
    - `dailyCap` unknown, required
  - `kaiSupport` object, required
    - `planAllows` boolean, required
    - `live` boolean, required
    - `installed` boolean, required
    - `agentId` string, required
  - `openUnowned` number, double, required
  - `boards` object[], required
    - `suggestion` object, required
      - `share` number, double, required
      - `teamId` string, required
    - `teamId` string, required
    - `assignTo` unknown, required
    - `icon` unknown, required
    - `name` string, required
    - `type` string, required
    - `kaiInvestigatesAvailable` boolean, required
    - `kaiInvestigates` boolean, required
  - `defaultTeam` string, required
  - `enabledAt` unknown, required
  - `enabled` boolean, required
  - `scheduled` number, double, required

## Changes

- **2026-10-29** `9008dc52d09c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gleap/apis/gleap-server/changes/teams/setup/post.md)

---

[API](https://skmtc.dev/gleap/apis/gleap-server.md) - [All operations](https://skmtc.dev/gleap/apis/gleap-server/llms.txt) - [OpenAPI document](https://skmtc.dev/gleap/apis/gleap-server/revisions/2ec9bd6c1903?raw)