--- title: "Update any subset of a link type" method: PATCH path: "/api/event-types/{id}" tags: ["Booking links"] --- # Update any subset of a link type `PATCH /api/event-types/{id}` ## Request - Base URL: `https://whenmeet.me` - URL: `https://whenmeet.me/api/event-types/{id}` - Auth: one of: - HTTP bearer - API key in cookie `__Host-session` A team change diffs members (new ones invited, removed ones dropped); a partial team ({ mode: "any" }) keeps the rest. team: null turns it back into a personal link and releases its team handle. Personal links may set or clear a weeklyHours + hoursTimezone pair; setting an override on a team link is rejected. A new or moved teamHandle is claimed first: 409 handle_taken changes nothing, and a later slug_taken puts the old handle back. teamHandle: null releases it; teamName alone renames it. ## Path parameters - `id` string, required ## Request body - EventTypeInput: Link type settings. Only title is needed to create one; everything else has a sensible default. - `title` string - `slug` string: Default: from the title (-2, -3 … appended if taken). - `description` string, nullable - `durationMin` integer - `conference` 'meet' | 'teams' | 'null', nullable: Default: meet for a Google calendar, teams for Microsoft. - `bufferBeforeMin` integer - `bufferAfterMin` integer - `minNoticeMin` integer - `maxDaysAhead` integer - `slotStepMin` 5 | 10 | 15 | 20 | 30 | 45 | 60 | 90 | 120 - `dailyLimit` integer, nullable - `questions` BookingQuestion[]: Name and email are always collected. - `id` string, required - `label` string, required - `type` 'text' | 'textarea', required - `required` boolean, required - `weeklyHours` WeeklyHours: Working hours per weekday in the profile timezone, or in hoursTimezone for a personal link override: up to 6 ["HH:MM","HH:MM"] intervals per day ("24:00" allowed as an end). Missing days mean no hours; overlapping intervals merge. Profile default Mon–Fri 09:00–17:00. - `mon` array[] - string[] - `tue` array[] - string[] - `wed` array[] - string[] - `thu` array[] - string[] - `fri` array[] - string[] - `sat` array[] - string[] - `sun` array[] - string[] - `hoursTimezone` string, nullable: IANA timezone for weeklyHours. A non-null weeklyHours needs a valid non-null zone; clear both to follow the profile (invalid_hours_timezone on a mismatched pair). - `reminders` integer[]: Reminder emails to the invitee and guests, in minutes before the start (24 h and 1 h by default). Any 3 of the allowed values; duplicates collapse, stored sorted descending. [] turns reminders off; null resets to the default. Error: invalid_reminders. - `active` boolean - `team` TeamSettings: Turns a link into a TEAM link. mode "all" = every member must be free (e.g. a two-person interview panel); "any" = whoever is free, assigned in turn (round-robin). Members get an email invite and join with one calendar connect. - `mode` 'all' | 'any', required - `members` string[]: Colleagues to invite (you excluded). - `includeMe` boolean: You attend / can be assigned too. Default true. - `teamHandle` string, nullable: Team links only: the link’s own public address, whenmeet.me/@ (same rules as nicknames and the same namespace; a leading @ and upper case are forgiven). null or "" releases it; turning the link personal releases it too. Errors: invalid_team_handle (bad handle, or the link is / becomes personal), 409 handle_taken (held by any nickname — yours included — or another link; nothing changes), 400 too_many_team_handles (you already hold 5 team handles on other links; nothing changes). - `teamName` string, nullable: Shown with the team handle ("Acme Sales"); null → the link title. Stored only next to a team handle (ignored without one). Error: invalid_team_name. ## Response `200` { eventType } - object - `eventType` EventType - `id` string - `slug` string - `title` string - `description` string, nullable - `durationMin` integer - `conference` 'meet' | 'teams' | 'null', nullable - `bufferBeforeMin` integer - `bufferAfterMin` integer - `minNoticeMin` integer - `maxDaysAhead` integer - `slotStepMin` integer - `dailyLimit` integer, nullable - `questions` BookingQuestion[] - `id` string, required - `label` string, required - `type` 'text' | 'textarea', required - `required` boolean, required - `weeklyHours` WeeklyHours: Working hours per weekday in the profile timezone, or in hoursTimezone for a personal link override: up to 6 ["HH:MM","HH:MM"] intervals per day ("24:00" allowed as an end). Missing days mean no hours; overlapping intervals merge. Profile default Mon–Fri 09:00–17:00. - `mon` array[] - string[] - `tue` array[] - string[] - `wed` array[] - string[] - `thu` array[] - string[] - `fri` array[] - string[] - `sat` array[] - string[] - `sun` array[] - string[] - `hoursTimezone` string, nullable: Timezone for the personal link’s weeklyHours override; null when following the profile. - `reminders` integer[]: Minutes before the start, sorted descending; [] = off. - `active` boolean - `position` integer - `url` string, uri: Public booking URL, e.g. https://whenmeet.me/@anna/intro - `team` object, nullable - `mode` 'all' | 'any' - `members` TeamMember[] - `email` string, email - `name` string, nullable - `status` 'pending' | 'active' | 'declined' - `isOwner` boolean - `visibility` 'self' | 'org' | 'none': self = joined, their own calendar is used; org = not joined yet but your calendar account can see their free/busy (same Workspace / Microsoft 365 org); none = not visible until they join (excluded from the check). - `hours` ParticipantHours: The working hours a team participant is checked against (owner view only — never public). Every teammate is checked against their OWN hours: own = their booking profile (also your own entry); default = joined but no profile yet: Mon–Fri 09:00–17:00 in their account timezone (UTC if unknown); owner = not joined yet (pending / declined): your hours and zone. - `weeklyHours` WeeklyHours, required: Working hours per weekday in the profile timezone, or in hoursTimezone for a personal link override: up to 6 ["HH:MM","HH:MM"] intervals per day ("24:00" allowed as an end). Missing days mean no hours; overlapping intervals merge. Profile default Mon–Fri 09:00–17:00. - `mon` array[] - … - `tue` array[] - … - `wed` array[] - … - `thu` array[] - … - `fri` array[] - … - `sat` array[] - … - `sun` array[] - … - `tz` string, required: IANA zone the hours are in. - `source` 'own' | 'default' | 'owner', required - `health` TeamHealth: Can this team link take bookings right now? The same strict calendar read the public page does (today in the link zone + 14 days), served from its 60 s cache. Inactive links are not read and report ok. - `ok` boolean, required - `reason` 'member_unreadable' | 'no_checkable_member' | 'null', nullable, required: member_unreadable = an "all" participant, or every "any" participant, can’t be read (an "any" link with only some unreadable stays ok); no_checkable_member = nobody can be checked, or you have no calendar connected. - `memberEmail` string, nullable, required: The first unreadable participant (member_unreadable only). - `teamHandle` string, nullable: The team link’s own handle (null for personal links and team links without one). - `teamName` string, nullable - `teamUrl` string, uri, nullable: https://whenmeet.me/@, or null. ## Other responses - `400`: invalid_body | no_profile | invalid_ (incl. invalid_reminders, invalid_weekly_hours, invalid_hours_timezone, invalid_team_handle, invalid_team_name) | too_many_team_members | too_many_team_handles. - `401`: unauthenticated (no session or token), or invalid_token (a Bearer token that is malformed, unknown or revoked — never a silent anonymous fallback). - `404`: not_found (not yours). - `409`: slug_taken | handle_taken. --- [API](https://skmtc.dev/whenmeet/apis/whenmeet-me-api.md) · [All operations](https://skmtc.dev/whenmeet/apis/whenmeet-me-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whenmeet/apis/whenmeet-me-api/revisions/202b80022215?raw)