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

# Update a booking limit pool

> Changes only the fields sent. An interval sent as null is removed. Changing the mode or event types keeps every host's own limit. If accessed using an OAuth access token, the `TEAM_EVENT_TYPE_WRITE` scope is required.



## OpenAPI

````yaml /api-reference/v2/openapi.json patch /v2/teams/{teamId}/booking-limit-pools/{poolId}
openapi: 3.0.0
info:
  title: Cal.com API v2
  description: ''
  version: 1.0.0
  contact: {}
servers: []
security: []
tags: []
paths:
  /v2/teams/{teamId}/booking-limit-pools/{poolId}:
    patch:
      tags:
        - Teams / Booking limit pools
      summary: Update a booking limit pool
      description: >-
        Changes only the fields sent. An interval sent as null is removed.
        Changing the mode or event types keeps every host's own limit. If
        accessed using an OAuth access token, the `TEAM_EVENT_TYPE_WRITE` scope
        is required.
      operationId: TeamsBookingLimitPoolsController_update
      parameters:
        - name: Authorization
          in: header
          description: >-
            value must be `Bearer <token>` where `<token>` is api key prefixed
            with cal_, managed user access token, or OAuth access token
          required: true
          schema:
            type: string
        - name: poolId
          required: true
          in: path
          description: Pool UUID; short UUID form is accepted too.
          schema:
            type: string
            format: uuid
        - name: teamId
          required: true
          in: path
          description: >-
            The team's uuid (preferred), its short-uuid (Flickr Base58) form, or
            its numeric id.
          schema:
            anyOf:
              - type: string
              - type: number
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateBookingLimitPoolInput'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BookingLimitPoolResponseOutput'
components:
  schemas:
    UpdateBookingLimitPoolInput:
      type: object
      properties:
        perDay:
          type: number
          nullable: true
          minimum: 1
          example: 2
        perWeek:
          type: number
          nullable: true
          minimum: 1
          example: 5
        perMonth:
          type: number
          nullable: true
          minimum: 1
        perYear:
          type: number
          nullable: true
          minimum: 1
        name:
          type: string
          minLength: 1
          example: Engineering interviews
        mode:
          enum:
            - SHARED
            - PER_EVENT
          type: string
          description: Changing the mode keeps every host's own limit.
        eventTypeIds:
          uniqueItems: true
          minItems: 1
          maxItems: 100
          example:
            - 0bce7b70-d7f0-4e5f-bcce-2f41b6fd5116
            - 15314c7c-11a0-440d-9ae9-23593c193a2b
          description: Replaces the pool's event types.
          type: array
          items:
            type: string
            format: uuid
    BookingLimitPoolResponseOutput:
      type: object
      properties:
        status:
          type: string
          enum:
            - success
        data:
          $ref: '#/components/schemas/BookingLimitPoolOutput'
      required:
        - status
        - data
    BookingLimitPoolOutput:
      type: object
      properties:
        perDay:
          type: number
          nullable: true
          example: 4
        perWeek:
          type: number
          nullable: true
          example: 20
        perMonth:
          type: number
          example: 60
          nullable: true
        perYear:
          type: number
          nullable: true
          example: 500
        id:
          type: string
          format: uuid
        teamId:
          type: number
        name:
          type: string
        mode:
          enum:
            - SHARED
            - PER_EVENT
          type: string
        archived:
          type: boolean
          readOnly: true
          description: An archived pool is skipped by enforcement until it is restored.
        eventTypes:
          type: array
          items:
            $ref: '#/components/schemas/BookingLimitPoolEventTypeOutput'
      required:
        - perDay
        - perWeek
        - perMonth
        - perYear
        - id
        - teamId
        - name
        - mode
        - archived
        - eventTypes
    BookingLimitPoolEventTypeOutput:
      type: object
      properties:
        id:
          type: string
          format: uuid
        title:
          type: string
      required:
        - id
        - title

````

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