> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gleap.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Set the boards' team setup

> 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.



## OpenAPI

````yaml https://api.gleap.io/api-docs.json post /teams/setup
openapi: 3.0.0
info:
  title: gleap-server
  version: 14.0.0
  contact: {}
servers:
  - url: https://api.gleap.io/v3
security: []
paths:
  /teams/setup:
    post:
      tags:
        - Team
      summary: Set the boards' team setup
      description: >-
        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.
      operationId: SetTeamSetup
      parameters:
        - in: header
          name: project
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TeamSetupDto'
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                properties:
                  escalationBoard:
                    type: string
                  escalationLimits:
                    properties:
                      reached: {}
                      today: {}
                      monthlyBudgetMinor: {}
                      dailyCap: {}
                    required:
                      - reached
                      - today
                      - monthlyBudgetMinor
                      - dailyCap
                    type: object
                  kaiSupport:
                    properties:
                      planAllows:
                        type: boolean
                      live:
                        type: boolean
                      installed:
                        type: boolean
                      agentId:
                        type: string
                    required:
                      - planAllows
                      - live
                      - installed
                      - agentId
                    type: object
                  openUnowned:
                    type: number
                    format: double
                  boards:
                    items:
                      properties:
                        suggestion:
                          properties:
                            share:
                              type: number
                              format: double
                            teamId:
                              type: string
                          required:
                            - share
                            - teamId
                          type: object
                        teamId:
                          type: string
                        assignTo: {}
                        icon: {}
                        name:
                          type: string
                        type:
                          type: string
                        kaiInvestigatesAvailable:
                          type: boolean
                        kaiInvestigates:
                          type: boolean
                      required:
                        - suggestion
                        - teamId
                        - assignTo
                        - icon
                        - name
                        - type
                        - kaiInvestigatesAvailable
                        - kaiInvestigates
                      type: object
                    type: array
                  defaultTeam:
                    type: string
                  enabledAt: {}
                  enabled:
                    type: boolean
                  scheduled:
                    type: number
                    format: double
                required:
                  - escalationBoard
                  - escalationLimits
                  - kaiSupport
                  - openUnowned
                  - boards
                  - defaultTeam
                  - enabledAt
                  - enabled
                  - scheduled
                type: object
      security:
        - jwt: []
components:
  schemas:
    TeamSetupDto:
      description: >-
        POST /teams/setup: team routing on or off, the default team, and each
        board's team.
      properties:
        enabled:
          type: boolean
        defaultTeam:
          type: string
          nullable: true
        boards:
          items:
            properties:
              kaiInvestigates:
                type: boolean
              assignTo:
                properties:
                  team:
                    type: string
                    nullable: true
                  mode:
                    type: string
                    enum:
                      - default
                      - team
                      - nobody
                required:
                  - mode
                type: object
              type:
                type: string
            required:
              - type
            type: object
          type: array
          description: >-
            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.
        escalationBoard:
          type: string
          nullable: true
          description: >-
            Where an escalated conversation lands (a board type; bugs always
            land on Bugs). Null: Conversations.
        escalationLimits:
          properties:
            monthlyBudgetMinor:
              type: number
              format: double
              nullable: true
            dailyCap:
              type: number
              format: double
          type: object
          description: >-
            Kai Support's escalated stage: escalated tickets a day, and a
            monthly budget in USD cents (null: none).
        assignOpenUnowned:
          type: boolean
          description: >-
            Also give today's open tickets nobody owns to their board's team
            (only with `enabled: true`).
      type: object
      additionalProperties: false
  securitySchemes:
    jwt:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.