Booking links

Update any subset of a link type

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.

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

Path parameters

idstring required

Request body

titlestring
slugstring

Default: from the title (-2, -3 … appended if taken).

descriptionstring nullable
durationMininteger
conference'meet' | 'teams' | 'null' nullable

Default: meet for a Google calendar, teams for Microsoft.

bufferBeforeMininteger
bufferAfterMininteger
minNoticeMininteger
maxDaysAheadinteger
slotStepMin5 | 10 | 15 | 20 | 30 | 45 | 60 | 90 | 120
dailyLimitinteger nullable
hoursTimezonestring 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).

remindersinteger[]

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.

activeboolean
teamHandlestring nullable

Team links only: the link’s own public address, whenmeet.me/@<teamHandle> (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).

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

Example request

{
  "weeklyHours": {
    "mon": [
      [
        "09:00",
        "17:00"
      ]
    ],
    "tue": [
      [
        "09:00",
        "12:00"
      ],
      [
        "13:00",
        "17:00"
      ]
    ],
    "sat": [],
    "sun": []
  }
}

Response

{ eventType }

Example response

{
  "eventType": {
    "weeklyHours": {
      "mon": [
        [
          "09:00",
          "17:00"
        ]
      ],
      "tue": [
        [
          "09:00",
          "12:00"
        ],
        [
          "13:00",
          "17:00"
        ]
      ],
      "sat": [],
      "sun": []
    },
    "team": {
      "members": [
        {
          "hours": {
            "weeklyHours": {
              "mon": [
                [
                  "09:00",
                  "17:00"
                ]
              ],
              "tue": [
                [
                  "09:00",
                  "12:00"
                ],
                [
                  "13:00",
                  "17:00"
                ]
              ],
              "sat": [],
              "sun": []
            }
          }
        }
      ]
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.