> ## Documentation Index > Fetch the complete documentation index at: https://cal.id/docs/llms.txt > Use this file to discover all available pages before exploring further. # Update a team event type > Update a team event type ## OpenAPI ````yaml /openapi.json patch /teams/{teamId}/event-types/{eventTypeId} openapi: 3.1.0 info: title: Cal ID API description: >- API documentation for external developers integrating with Cal ID. This documentation is auto-generated from our OpenAPI specification and includes details on all available endpoints, request/response schemas, and authentication methods. Authentication is required for all endpoints and can be done using API key generated from the Cal ID dashboard under the `settings/developer/api-keys` page. Use the Authorization header with the Bearer scheme to authenticate your requests. Example: - API Key: `Authorization: Bearer calid_xxxxx` Note: To manage Team's resources use the Team's owner/admin API key version: 1.0.0 contact: name: API Support email: support@cal.id url: https://cal.id license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://api.cal.id description: 'Production server ' security: - bearerAuth: [] tags: - name: Health description: Health check endpoints - name: Users description: User management endpoints - name: Event Types description: Event type management endpoints - name: Teams description: Team management endpoints - name: Team Event Types description: Event type management endpoints for teams - name: Team Memberships description: Membership management endpoints for teams - name: Team Schedules description: Schedule management endpoints for teams - name: Availability description: User availability management endpoints - name: Schedule description: User schedule management endpoints - name: Slots description: Available slots retrieval endpoints - name: Booking description: Event booking endpoints paths: /teams/{teamId}/event-types/{eventTypeId}: patch: tags: - Team Event Types summary: Update a team event type description: Update a team event type operationId: update_team_eventtype parameters: - schema: type: integer exclusiveMinimum: 0 example: 42 minimum: 1 in: path name: teamId required: true description: Numeric team identifier. - schema: type: integer exclusiveMinimum: 0 example: 7 minimum: 1 in: path name: eventTypeId required: true description: Numeric team event type identifier. requestBody: content: application/json: schema: type: object properties: title: type: string minLength: 4 maxLength: 255 description: >- Human-readable title for the event type shown in booking pages and calendars. example: 30 Minute Discovery Call slug: type: string minLength: 4 maxLength: 100 description: Unique URL slug for the event type under the owner account. example: discovery-call-30 description: description: Optional event type description shown to bookers. example: >- A short introductory call to discuss your goals and next steps. type: string nullable: true interfaceLanguage: description: Interface language used for the booking experience. example: en type: string nullable: true position: type: integer default: 0 description: Sort position used when listing multiple event types. example: 0 locations: type: array description: >- Location or conferencing configuration payload for this event type. Each item type must be one of the supported location type enum values. example: - type: attendeeInPerson attendeeAddress: 221B Baker Street, London - type: inPerson address: OneHash HQ, Bengaluru - type: phone phone: '+14155551234' - type: userPhone - type: link link: https://meet.example.com/discovery-call - type: conferencing hostDefault: integrations:google:meet - type: somewhereElse somewhereElse: Client office lobby items: type: object additionalProperties: true properties: type: type: string enum: - attendeeInPerson - inPerson - phone - userPhone - link - conferencing - somewhereElse - integrations:calidrooms - integrations:campfire_video - integrations:daily - integrations:demodesk_video - integrations:dialpad_video - integrations:discord_video - integrations:eightxeight_video - integrations:element-call_video - integrations:facetime_video - integrations:google:meet - integrations:horizon-workrooms_video - integrations:huddle01_video - integrations:jelly_conferencing - integrations:jitsi - integrations:mirotalk_video - integrations:nextcloudtalk_conferencing - integrations:office365_video - integrations:ping_video - integrations:riverside_video - integrations:roam_video - integrations:salesroom_video - integrations:shimmer_video - integrations:signal_video - integrations:sirius_video_video - integrations:skype_video - integrations:sylaps_video - integrations:tandem - integrations:telegram_video - integrations:event-type-location-video-static_video - integrations:webex_video - integrations:whatsapp_video - integrations:whereby_video - integrations:zoom description: Supported event location type identifier. example: integrations:google:meet attendeeAddress: type: string description: >- Invitee-provided address value when type is `attendeeInPerson`. example: 221B Baker Street, London address: type: string description: >- Organizer-provided address value when type is `inPerson`. example: OneHash HQ, Bengaluru phone: type: string description: Invitee-provided phone number when type is `phone`. example: '+14155551234' hostPhoneNumber: type: string description: >- Organizer-provided phone number when type is `userPhone`. example: '+14155559876' link: type: string description: Meeting link value when type is `link`. example: https://meet.example.com/discovery-call hostDefault: type: string description: >- Default conferencing provider value when type is `conferencing`. example: integrations:google:meet somewhereElse: type: string description: >- Custom attendee-entered location value when type is `somewhereElse`. example: Client office lobby required: - type nullable: true length: type: integer minimum: 10 default: 15 description: Meeting duration in minutes. example: 30 offsetStart: type: integer default: 0 description: Offset in minutes added to generated slot start times. example: 0 hidden: type: boolean default: false description: >- Whether the event type should be hidden from public listings. example: false timeZone: description: IANA timezone used when event type timezone is locked. example: Asia/Kolkata type: string nullable: true periodType: type: string enum: - UNLIMITED - ROLLING - ROLLING_WINDOW - RANGE default: UNLIMITED description: Availability period strategy for booking this event type. example: UNLIMITED periodStartDate: description: Start date-time boundary for limited booking windows. example: '2026-05-01T00:00:00.000Z' type: string format: date-time nullable: true periodEndDate: description: End date-time boundary for limited booking windows. example: '2026-05-31T23:59:59.000Z' type: string format: date-time nullable: true periodDays: description: Number of days allowed for period-based booking limits. example: 30 type: integer nullable: true periodCountCalendarDays: description: >- Whether period day counting should use calendar-day boundaries. example: true type: boolean nullable: true requiresConfirmation: type: boolean default: false description: Whether new bookings require organizer confirmation. example: false requiresConfirmationWillBlockSlot: type: boolean default: false description: >- Whether pending confirmation should block the slot from other bookings. example: false requiresConfirmationForFreeEmail: type: boolean default: false description: >- Whether confirmation is enforced for bookers using free email domains. example: false requiresBookerEmailVerification: type: boolean default: false description: >- Whether the booker must verify email before finalizing booking. example: false recurringEvent: description: Recurring event configuration payload. example: count: 4 frequency: weekly disableGuests: type: boolean default: false description: Whether attendees are prevented from adding guests. example: false hideCalendarNotes: type: boolean default: false description: Whether internal calendar notes are hidden from attendees. example: false hideCalendarEventDetails: type: boolean default: false description: >- Whether detailed calendar event metadata is hidden from attendees. example: false minimumBookingNotice: type: integer minimum: 0 default: 120 description: >- Minimum notice in minutes required before a slot can be booked. example: 120 beforeEventBuffer: type: integer default: 0 description: Buffer time in minutes blocked before each booking. example: 0 afterEventBuffer: type: integer default: 0 description: Buffer time in minutes blocked after each booking. example: 0 seatsPerTimeSlot: description: Maximum seats available per slot for seat-based events. example: 5 type: integer nullable: true onlyShowFirstAvailableSlot: type: boolean default: false description: >- Whether only the first available slot should be displayed to bookers. example: false disableCancelling: default: false description: Whether guests are prevented from cancelling bookings. example: false type: boolean nullable: true disableRescheduling: default: false description: Whether guests are prevented from rescheduling bookings. example: false type: boolean nullable: true disableHostCancelling: default: false description: >- Whether hosts are prevented from cancelling bookings for team events. example: false type: boolean nullable: true disableHostRescheduling: default: false description: >- Whether hosts are prevented from rescheduling bookings for team events. example: false type: boolean nullable: true seatsShowAttendees: default: false description: >- Whether seat-based events should show attendee details to other attendees. example: false type: boolean nullable: true seatsShowAvailabilityCount: default: true description: >- Whether remaining seat availability count should be shown to bookers. example: true type: boolean nullable: true schedulingType: description: Scheduling strategy for owner/team assignment. example: COLLECTIVE type: string enum: - ROUND_ROBIN - COLLECTIVE - MANAGED nullable: true scheduleId: description: Schedule identifier linked to this event type. example: 1 type: integer nullable: true price: type: integer default: 0 description: Price amount in the smallest currency unit for paid events. example: 0 currency: type: string default: usd description: ISO currency code used when price is set. example: usd slotInterval: description: Custom interval in minutes between suggested slots. example: 15 type: integer nullable: true metadata: description: Arbitrary metadata payload stored with the event type. example: source: api successRedirectUrl: description: URL to redirect bookers to after successful booking. example: https://example.com/booking-success type: string format: uri nullable: true forwardParamsSuccessRedirect: default: true description: >- Whether booking query parameters should be appended to the success redirect URL. example: true type: boolean nullable: true bookingLimits: description: Booking limits configuration payload. example: PER_DAY: 5 durationLimits: description: Allowed duration limits configuration payload. example: minimum: 15 maximum: 60 isInstantEvent: type: boolean default: false description: >- Whether this event type can be booked instantly for near-immediate meetings. example: false instantMeetingExpiryTimeOffsetInSeconds: type: integer default: 90 description: Number of seconds before an instant meeting offer expires. example: 90 assignAllTeamMembers: type: boolean default: false description: >- Whether all team members should be assigned for this event type. example: false assignRRMembersUsingSegment: type: boolean default: false description: >- Whether round-robin members should be selected using a segment query. example: false rrSegmentQueryValue: description: >- Segment query payload used for round-robin member assignment. example: segment: enterprise useEventTypeDestinationCalendarEmail: type: boolean default: false description: >- Whether destination calendar email should be derived from event type settings. example: false isRRWeightsEnabled: type: boolean default: false description: Whether weighted round-robin distribution is enabled. example: false maxLeadThreshold: description: Maximum lead threshold used for assignment logic. example: 100 type: integer nullable: true includeNoShowInRRCalculation: type: boolean default: false description: >- Whether no-show bookings should be included in round-robin calculations. example: false allowReschedulingPastBookings: type: boolean default: false description: Whether past bookings are eligible for rescheduling. example: false hideOrganizerEmail: type: boolean default: false description: Whether organizer email is hidden from attendees. example: false maxActiveBookingsPerBooker: description: Maximum number of active bookings allowed per booker. example: 3 type: integer nullable: true maxActiveBookingPerBookerOfferReschedule: type: boolean default: false description: >- Whether over-limit bookers should be offered reschedule instead of blocking. example: false customReplyToEmail: description: Custom reply-to email used in booking communications. example: replyto@example.com type: string format: email nullable: true eventTypeColor: description: Custom color settings for the event type. example: lightEventTypeColor: '#0f172a' darkEventTypeColor: '#94a3b8' rescheduleWithSameRoundRobinHost: type: boolean default: false description: Whether reschedules should keep the same round-robin host. example: false useBookerTimezone: type: boolean default: false description: Whether booking flow should prioritize the booker timezone. example: false restrictionScheduleId: description: >- Schedule identifier used to restrict availability for this event type. example: 2 type: integer nullable: true bookingFields: type: array description: Full replacement list of user-managed booking fields. example: - name: company type: text label: Company required: false placeholder: Acme Inc. - name: company_size type: select label: Company size required: true options: - label: 1-10 value: 1-10 - label: 11-50 value: 11-50 items: type: object properties: name: type: string minLength: 1 maxLength: 128 pattern: ^[A-Za-z_][A-Za-z0-9_.-]*$ description: >- Stable response key for this user-managed booking field. System field names are reserved. type: type: string enum: - text - textarea - number - phone - address - multiemail - select - multiselect - checkbox - radio - boolean - url - attachment description: Supported user-managed booking field type. label: type: string minLength: 1 maxLength: 255 description: Booker-facing field label. placeholder: type: string maxLength: 255 description: Optional placeholder text. required: type: boolean description: Whether bookers must answer this field. hidden: type: boolean description: >- Whether this user-managed field is hidden from bookers. options: type: array items: type: object properties: label: type: string minLength: 1 maxLength: 255 value: type: string minLength: 1 maxLength: 255 required: - label - value additionalProperties: false description: >- Required for select, multiselect, checkbox, and radio fields. minLength: type: integer minimum: 0 description: Minimum response length for text and textarea fields. maxLength: type: integer minimum: 1 description: Maximum response length for text and textarea fields. required: - name - type - label additionalProperties: false nullable: true additionalProperties: false example: title: Updated Discovery Call responses: '200': description: Team event type updated successfully content: application/json: schema: type: object properties: success: type: boolean enum: - true data: type: object properties: id: type: number title: type: string slug: type: string description: type: - 'null' - string interfaceLanguage: type: - 'null' - string position: type: number locations: anyOf: - {} - type: 'null' bookingFields: anyOf: - {} - type: 'null' length: type: number offsetStart: type: number hidden: type: boolean userId: type: - 'null' - number teamId: type: - 'null' - number profileId: type: - 'null' - number timeZone: type: - 'null' - string periodType: type: string periodStartDate: anyOf: - type: string format: date-time - type: 'null' periodEndDate: anyOf: - type: string format: date-time - type: 'null' periodDays: type: - 'null' - number periodCountCalendarDays: type: - 'null' - boolean lockTimeZoneToggleOnBookingPage: type: boolean lockedTimeZone: type: - 'null' - string requiresConfirmation: type: boolean requiresConfirmationWillBlockSlot: type: boolean requiresConfirmationForFreeEmail: type: boolean requiresBookerEmailVerification: type: boolean recurringEvent: anyOf: - {} - type: 'null' disableGuests: type: boolean hideCalendarNotes: type: boolean hideCalendarEventDetails: type: boolean minimumBookingNotice: type: number beforeEventBuffer: type: number afterEventBuffer: type: number seatsPerTimeSlot: type: - 'null' - number onlyShowFirstAvailableSlot: type: boolean disableCancelling: type: - 'null' - boolean disableRescheduling: type: - 'null' - boolean disableHostCancelling: type: - 'null' - boolean disableHostRescheduling: type: - 'null' - boolean seatsShowAttendees: type: - 'null' - boolean seatsShowAvailabilityCount: type: - 'null' - boolean schedulingType: type: - 'null' - string scheduleId: type: - 'null' - number price: type: number currency: type: string slotInterval: type: - 'null' - number metadata: anyOf: - {} - type: 'null' successRedirectUrl: type: - 'null' - string forwardParamsSuccessRedirect: type: - 'null' - boolean bookingLimits: anyOf: - {} - type: 'null' durationLimits: anyOf: - {} - type: 'null' isInstantEvent: type: boolean instantMeetingExpiryTimeOffsetInSeconds: type: number assignAllTeamMembers: type: boolean assignRRMembersUsingSegment: type: boolean rrSegmentQueryValue: anyOf: - {} - type: 'null' useEventTypeDestinationCalendarEmail: type: boolean isRRWeightsEnabled: type: boolean maxLeadThreshold: type: - 'null' - number includeNoShowInRRCalculation: type: boolean allowReschedulingPastBookings: type: boolean hideOrganizerEmail: type: boolean maxActiveBookingsPerBooker: type: - 'null' - number maxActiveBookingPerBookerOfferReschedule: type: boolean customReplyToEmail: type: - 'null' - string eventTypeColor: anyOf: - {} - type: 'null' rescheduleWithSameRoundRobinHost: type: boolean secondaryEmailId: type: - 'null' - number useBookerTimezone: type: boolean restrictionScheduleId: type: - 'null' - number createdDate: anyOf: - type: string format: date-time - type: 'null' updatedDate: anyOf: - type: string format: date-time - type: 'null' required: - id - title - slug - description - interfaceLanguage - position - length - offsetStart - hidden - userId - teamId - profileId - timeZone - periodType - periodStartDate - periodEndDate - periodDays - periodCountCalendarDays - lockTimeZoneToggleOnBookingPage - lockedTimeZone - requiresConfirmation - requiresConfirmationWillBlockSlot - requiresConfirmationForFreeEmail - requiresBookerEmailVerification - disableGuests - hideCalendarNotes - hideCalendarEventDetails - minimumBookingNotice - beforeEventBuffer - afterEventBuffer - seatsPerTimeSlot - onlyShowFirstAvailableSlot - disableCancelling - disableRescheduling - disableHostCancelling - disableHostRescheduling - seatsShowAttendees - seatsShowAvailabilityCount - schedulingType - scheduleId - price - currency - slotInterval - successRedirectUrl - forwardParamsSuccessRedirect - isInstantEvent - instantMeetingExpiryTimeOffsetInSeconds - assignAllTeamMembers - assignRRMembersUsingSegment - useEventTypeDestinationCalendarEmail - isRRWeightsEnabled - maxLeadThreshold - includeNoShowInRRCalculation - allowReschedulingPastBookings - hideOrganizerEmail - maxActiveBookingsPerBooker - maxActiveBookingPerBookerOfferReschedule - customReplyToEmail - rescheduleWithSameRoundRobinHost - secondaryEmailId - useBookerTimezone - restrictionScheduleId additionalProperties: false message: type: string meta: type: object properties: pagination: type: object properties: page: type: number limit: type: number total: type: number totalPages: type: number required: - page - limit - total - totalPages additionalProperties: false additionalProperties: {} required: - success additionalProperties: false description: Team event type updated successfully '400': description: Invalid event type data content: application/json: schema: type: object properties: success: type: boolean enum: - false message: type: string error: type: object properties: code: type: string message: type: string details: {} required: - code - message additionalProperties: false required: - success - message - error additionalProperties: false description: Invalid event type data '401': description: Unauthorized content: application/json: schema: type: object properties: success: type: boolean enum: - false message: type: string error: type: object properties: code: type: string message: type: string details: {} required: - code - message additionalProperties: false required: - success - message - error additionalProperties: false description: Unauthorized '403': description: Insufficient permissions content: application/json: schema: type: object properties: success: type: boolean enum: - false message: type: string error: type: object properties: code: type: string message: type: string details: {} required: - code - message additionalProperties: false required: - success - message - error additionalProperties: false description: Insufficient permissions '404': description: Team event type not found content: application/json: schema: type: object properties: success: type: boolean enum: - false message: type: string error: type: object properties: code: type: string message: type: string details: {} required: - code - message additionalProperties: false required: - success - message - error additionalProperties: false description: Team event type not found '409': description: Event type slug already exists content: application/json: schema: type: object properties: success: type: boolean enum: - false message: type: string error: type: object properties: code: type: string message: type: string details: {} required: - code - message additionalProperties: false required: - success - message - error additionalProperties: false description: Event type slug already exists security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT | API Key description: |- Use the Authorization header with Bearer scheme. Examples: - API Key: Authorization: Bearer calid_xxxxx ```` ## Related topics - [Update an event type](/docs/api-reference/event-types/update-an-event-type.md) - [Delete a team event type](/docs/api-reference/team-event-types/delete-a-team-event-type.md) - [Get a team event type](/docs/api-reference/team-event-types/get-a-team-event-type.md) - [List team event types](/docs/api-reference/team-event-types/list-team-event-types.md) - [Create a team event type](/docs/api-reference/team-event-types/create-a-team-event-type.md)