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

# Set a host's limit for a pool

> Sets the host's own limit for the intervals sent; null returns that interval to the pool's limit. Only intervals the pool limits can be set, and each is capped at the host's overall booking 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}/hosts/{userId}
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}/hosts/{userId}:
    patch:
      tags:
        - Teams / Booking limit pools
      summary: Set a host's limit for a pool
      description: >-
        Sets the host's own limit for the intervals sent; null returns that
        interval to the pool's limit. Only intervals the pool limits can be set,
        and each is capped at the host's overall booking limit. If accessed
        using an OAuth access token, the `TEAM_EVENT_TYPE_WRITE` scope is
        required.
      operationId: TeamsBookingLimitPoolsController_updateHost
      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: teamId
          required: true
          in: path
          schema:
            type: number
        - name: poolId
          required: true
          in: path
          description: Pool UUID; short UUID form is accepted too.
          schema:
            type: string
            format: uuid
        - name: userId
          required: true
          in: path
          description: User UUID; short UUID form is accepted too.
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateBookingLimitPoolHostInput'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BookingLimitPoolHostResponseOutput'
components:
  schemas:
    UpdateBookingLimitPoolHostInput:
      type: object
      properties:
        hostLimit:
          description: >-
            The intervals to change; an omitted interval is left alone and null
            returns it to the pool's limit.
          allOf:
            - $ref: '#/components/schemas/BookingLimitsPatchInput'
      required:
        - hostLimit
    BookingLimitPoolHostResponseOutput:
      type: object
      properties:
        status:
          type: string
          enum:
            - success
        data:
          $ref: '#/components/schemas/BookingLimitPoolHostOutput'
      required:
        - status
        - data
    BookingLimitsPatchInput:
      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
    BookingLimitPoolHostOutput:
      type: object
      properties:
        userId:
          type: string
          format: uuid
        hostLimit:
          nullable: true
          description: >-
            The host's own limits; null while every interval uses the pool's
            limits.
          type: object
          allOf:
            - $ref: '#/components/schemas/BookingLimitsOutput'
        effectiveLimit:
          description: The limits enforced for this host.
          allOf:
            - $ref: '#/components/schemas/BookingLimitsOutput'
      required:
        - userId
        - hostLimit
        - effectiveLimit
    BookingLimitsOutput:
      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
      required:
        - perDay
        - perWeek
        - perMonth
        - perYear

````

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