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

# Replace a host's limit for a pool

> Replaces the host's own limit with the intervals sent; an omitted interval returns to the pool's limit, so sending the same body again changes nothing. 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 put /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}:
    put:
      tags:
        - Teams / Booking limit pools
      summary: Replace a host's limit for a pool
      description: >-
        Replaces the host's own limit with the intervals sent; an omitted
        interval returns to the pool's limit, so sending the same body again
        changes nothing. 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_setHost
      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: userId
          required: true
          in: path
          description: User 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/SetBookingLimitPoolHostInput'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BookingLimitPoolHostResponseOutput'
components:
  schemas:
    SetBookingLimitPoolHostInput:
      type: object
      properties:
        hostLimit:
          description: >-
            The host's complete limit; an omitted or null interval uses the
            pool's limit, and an empty object clears the host's own 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.