Sign in
Teams

Update a team

patch/v2/teams/{teamId}

Path parameters

teamIdnumber required

Headers

Authorizationstring required

value must be Bearer <token> where <token> is api key prefixed with cal_

Request body

namestring

Name of the team

slugstring

Team slug

logoUrlstring

URL of the teams logo image

calVideoLogostring
appLogostring
appIconLogostring
biostring
hideBrandingboolean
isPrivateboolean
hideBookATeamMemberboolean
metadataobject

You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters. Values can be strings (up to 500 characters), numbers, or booleans.

themestring
brandColorstring
darkBrandColorstring
bannerUrlstring

URL of the teams banner image which is shown on booker

timeFormatnumber
timeZonestring

Timezone is used to create teams's default schedule from Monday to Friday from 9AM to 5PM. It will default to Europe/London if not passed.

weekStartstring
bookingLimitsstring
includeManagedEventsInLimitsboolean

Example request

{
  "name": "CalTeam",
  "slug": "caltel",
  "logoUrl": "https://i.cal.com/api/avatar/b0b58752-68ad-4c0d-8024-4fa382a77752.png",
  "metadata": {
    "key": "value"
  },
  "bannerUrl": "https://i.cal.com/api/avatar/949be534-7a88-4185-967c-c020b0c0bef3.png",
  "timeZone": "America/New_York",
  "weekStart": "Monday"
}

Response

status'success' | 'error' required

Example response

{
  "status": "success",
  "data": {
    "metadata": {
      "key": "value"
    }
  }
}

Changes