PATCH
/
event-types
/
{id}
curl --request PATCH \
  --url https://api.cal.com/v1/event-types/{id} \
  --header 'Content-Type: application/json' \
  --data '{
  "event-type": {
    "summary": "An example of event type PATCH request",
    "value": {
      "length": 60,
      "requiresConfirmation": true
    }
  }
}'

Authorizations

​
apiKey
string
query
required

Path Parameters

​
id
integer
required

ID of the eventType to edit

Query Parameters

​
apiKey
string
required

Your API Key

Body

application/json
Create a new event-type related to your user or team
​
length
integer

Duration of the event type in minutes

​
metadata
object

Metadata relating to event type. Pass {} if empty

​
title
string

Title of the event type

​
slug
string

Unique slug for the event type

​
scheduleId
number

The ID of the schedule for this event type

​
hosts
object[]
​
hidden
boolean

If the event type should be hidden from your public booking page

​
position
integer

The position of the event type on the public booking page

​
teamId
integer

Team ID if the event type should belong to a team

​
periodType
enum<string>

To decide how far into the future an invitee can book an event with you

Available options:
UNLIMITED,
ROLLING,
RANGE
​
periodStartDate
string

Start date of bookable period (Required if periodType is 'range')

​
periodEndDate
string

End date of bookable period (Required if periodType is 'range')

​
periodDays
integer

Number of bookable days (Required if periodType is rolling)

​
periodCountCalendarDays
boolean

If calendar days should be counted for period days

​
requiresConfirmation
boolean

If the event type should require your confirmation before completing the booking

​
recurringEvent
object

If the event should recur every week/month/year with the selected frequency

​
disableGuests
boolean

If the event type should disable adding guests to the booking

​
hideCalendarNotes
boolean

If the calendar notes should be hidden from the booking

​
minimumBookingNotice
integer

Minimum time in minutes before the event is bookable

​
beforeEventBuffer
integer

Number of minutes of buffer time before a Cal Event

​
afterEventBuffer
integer

Number of minutes of buffer time after a Cal Event

​
schedulingType
enum<string>

The type of scheduling if a Team event. Required for team events only

Available options:
ROUND_ROBIN,
COLLECTIVE
​
price
integer

Price of the event type booking

​
currency
string

Currency acronym. Eg- usd, eur, gbp, etc.

​
slotInterval
integer

The intervals of available bookable slots in minutes

​
successRedirectUrl
string

A valid URL where the booker will redirect to, once the booking is completed successfully

​
description
string

Description of the event type

​
seatsPerTimeSlot
integer

The number of seats for each time slot

​
seatsShowAttendees
boolean

Share Attendee information in seats

​
seatsShowAvailabilityCount
boolean

Show the number of available seats

​
locations
array

A list of all available locations for the event type

Response

201

OK, eventType edited successfully

Was this page helpful?

Suggest editsRaise issue