Tempi

Takes a handle, the first path segment of a booking link (https://host/acme/demo → "acme"), or the link itself. Returns the person or team and their bookable event types, with duration, price, and hosts with their time zones (`hostTimezones`, so you can say what time a slot is for them). A handle from before a rename also works. Next: call get_available_slots with one of the event type slugs.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "a handle, the first part of a booking link (\"acme\" in meettempi.com/acme/demo), or the whole link"
    }
  },
  "required": [
    "handle"
  ],
  "additionalProperties": false
}

Returns the start times that can be booked, with the hosts' calendars, buffers and limits already applied. Pass the invitee's `timezone` and either `date` (YYYY-MM-DD in `timezone`) or `from` and `to` (ISO, at most 62 days apart). With neither, it covers the next 7 days. `days` groups the slots by date in `timezone`, and `times` gives each slot as a local time to show people. People can book up to `bookableUntil`. When the range has no open times, `next` is the next one. When `timezone` was an abbreviation that names more than one zone (CST, IST, BST), `timezoneNote` says which one was used: check it with the person. For new times for an existing booking, also pass its `bookingId` and `token`. Next: call create_booking (or reschedule_booking_as_invitee) with one of the `slots` values as `start`.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "a handle, the first part of a booking link (\"acme\" in meettempi.com/acme/demo), or the whole link"
    },
    "slug": {
      "type": "string",
      "description": "an event type slug from get_public_profile (\"demo\" in meettempi.com/acme/demo), or the whole link"
    },
    "timezone": {
      "type": "string",
      "description": "the invitee's time zone, an IANA id like America/New_York or an abbreviation like EST: days, dates and times are in it"
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "one day to look at, as YYYY-MM-DD in `timezone`"
    },
    "from": {
      "type": "string",
      "format": "date-time",
      "description": "start of the range, ISO with an offset"
    },
    "to": {
      "type": "string",
      "format": "date-time",
      "description": "end of the range, ISO with an offset"
    },
    "bookingId": {
      "type": "string",
      "description": "the booking id from create_booking, or its manageUrl"
    },
    "token": {
      "type": "string",
      "description": "the token from create_booking, or the manageUrl"
    }
  },
  "required": [
    "handle",
    "slug",
    "timezone"
  ],
  "additionalProperties": false
}

For event types with `repeatMax` (from get_public_profile): lists each meeting of a series that starts at `start` (one of the slots) and repeats `every` 1, 2 or 4 weeks at the same local time, and whether each is free. Book it with create_booking and `repeat` when `bookable` is true. A series is booked whole or not at all, and round robin gives every meeting to the same host.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "a handle, the first part of a booking link (\"acme\" in meettempi.com/acme/demo), or the whole link"
    },
    "slug": {
      "type": "string",
      "description": "an event type slug from get_public_profile (\"demo\" in meettempi.com/acme/demo), or the whole link"
    },
    "start": {
      "type": "string",
      "format": "date-time",
      "description": "one of the `slots` values from get_available_slots, as given (ISO in UTC)"
    },
    "every": {
      "anyOf": [
        {
          "type": "number",
          "enum": [
            1,
            2,
            4
          ],
          "description": "weeks between meetings: 1, 2 or 4"
        },
        {
          "type": "string",
          "description": "a string to be decoded into a number"
        }
      ]
    },
    "count": {
      "anyOf": [
        {
          "type": "integer",
          "description": "how many meetings, first included (2 up to the event type's repeatMax)",
          "title": "between(2, 52)",
          "minimum": 2,
          "maximum": 52
        },
        {
          "type": "string",
          "description": "a string to be decoded into a number"
        }
      ]
    }
  },
  "required": [
    "handle",
    "slug",
    "start",
    "every",
    "count"
  ],
  "additionalProperties": false
}

Books `start`, which must be one of the `slots` from get_available_slots. Free events are confirmed at once, unless the event type has `requiresApproval`: then it's a request (status=pending_approval) that holds the time until a host approves or declines it, and the invitee hears either way by email. Tell the human it isn't confirmed yet. Paid events return status=pending_payment and a `paymentUrl`. Give it to the human to pay before `holdExpiresAt`, or the slot is released. Once confirmed, the event is added to the host's calendar if they connected one, and the invitee gets its invitation. Keep `manageUrl` and `token`: they are the only way to view, reschedule or cancel later. 409 slot_unavailable says why the time can't be booked and lists the `nearest` open times. The result's `when` is the start in the invitee's time zone, to tell them.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "a handle, the first part of a booking link (\"acme\" in meettempi.com/acme/demo), or the whole link"
    },
    "slug": {
      "type": "string",
      "description": "an event type slug from get_public_profile (\"demo\" in meettempi.com/acme/demo), or the whole link"
    },
    "start": {
      "type": "string",
      "format": "date-time",
      "description": "one of the `slots` values from get_available_slots, as given (ISO in UTC)"
    },
    "name": {
      "type": "string",
      "description": "the invitee's full name"
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "the invitee's email address, which gets the calendar invitation"
    },
    "timezone": {
      "type": "string",
      "description": "the invitee's time zone, an IANA id like America/New_York or an abbreviation like EST: their emails and reminders show times in it"
    },
    "notes": {
      "type": "string",
      "description": "anything the invitee wants the host to know",
      "title": "maxLength(2000)",
      "minLength": 0,
      "maxLength": 2000
    },
    "repeat": {
      "type": "object",
      "required": [
        "every",
        "count"
      ],
      "properties": {
        "every": {
          "type": "number",
          "enum": [
            1,
            2,
            4
          ],
          "description": "weeks between meetings: 1, 2 or 4"
        },
        "count": {
          "type": "integer",
          "description": "how many meetings, first included (2 up to the event type's repeatMax)",
          "title": "between(2, 52)",
          "minimum": 2,
          "maximum": 52
        }
      },
      "additionalProperties": false,
      "description": "book a series instead: `count` meetings, `every` 1, 2 or 4 weeks at the same local time, when the event type's repeatMax allows. All or nothing: check_series first"
    }
  },
  "required": [
    "handle",
    "slug",
    "start",
    "name",
    "email",
    "timezone"
  ],
  "additionalProperties": false
}

Returns a booking by its id and token (from create_booking), or its manageUrl passed as both, with `changeableUntil`, `refundableUntil`, `canCancel` and `cancelReasonRequired`. For a series, `series` lists every meeting with its own manageUrl.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "the booking id from create_booking, or its manageUrl"
    },
    "token": {
      "type": "string",
      "description": "the token from create_booking, or the manageUrl"
    }
  },
  "required": [
    "id",
    "token"
  ],
  "additionalProperties": false
}

Moves a confirmed booking to `start` with the same hosts. Get valid times from get_available_slots with this `bookingId` and `token`. The calendar event is updated and its provider notifies attendees. Payment carries over. Not possible after `changeableUntil` (409 change_too_late).

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "the booking id from create_booking, or its manageUrl"
    },
    "token": {
      "type": "string",
      "description": "the token from create_booking, or the manageUrl"
    },
    "start": {
      "type": "string",
      "format": "date-time",
      "description": "one of the `slots` values from get_available_slots, as given (ISO in UTC)"
    }
  },
  "required": [
    "id",
    "token",
    "start"
  ],
  "additionalProperties": false
}

Cancels a booking by its id and token. The event is removed from the host's calendar. Paid bookings cancelled before `refundableUntil` are refunded in full. Later cancellations get no refund. The event type sets the rules, which get_booking shows: no changes after `changeableUntil` (409 change_too_late), no cancelling when `canCancel` is false (409 cancel_not_allowed, reschedule instead), and a `reason` when `cancelReasonRequired` is true (422 reason_required).

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "the booking id from create_booking, or its manageUrl"
    },
    "token": {
      "type": "string",
      "description": "the token from create_booking, or the manageUrl"
    },
    "reason": {
      "type": "string",
      "description": "why the invitee cancels, sent to the host",
      "title": "maxLength(500)",
      "minLength": 0,
      "maxLength": 500
    },
    "following": {
      "type": "boolean",
      "description": "for a series: also cancel every later meeting"
    }
  },
  "required": [
    "id",
    "token"
  ],
  "additionalProperties": false
}

Requests access to host on Tempi (create event types, share a booking page). Not needed to book meetings, since booking pages are public. Returns the status: pending, approved (sign in to the Tempi web app), rejected, or open (no waitlist, sign in directly). Joining again with the same email returns the current status.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "description": "an email address"
    },
    "name": {
      "type": "string",
      "description": "a string at most 100 character(s) long",
      "title": "maxLength(100)",
      "minLength": 0,
      "maxLength": 100
    },
    "note": {
      "type": "string",
      "description": "a string at most 1000 character(s) long",
      "title": "maxLength(1000)",
      "minLength": 0,
      "maxLength": 1000
    },
    "ref": {
      "type": "string",
      "description": "a short source tag of lowercase letters, digits, - or _, like \"embed\"",
      "pattern": "^[a-z0-9_-]{1,32}$"
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}