---
title: "Relay availability for an invited guest (organizer path)"
method: POST
path: "/api/meetings/{id}/relay-availability"
tags: ["Meetings"]
---

# Relay availability for an invited guest (organizer path)

`POST /api/meetings/{id}/relay-availability`

## Request

- Base URL: `https://api.wondercal.com`
- URL: `https://api.wondercal.com/api/meetings/{id}/relay-availability`
- Auth: HTTP bearer

Allows the meeting organizer to submit availability slots on behalf of an invited guest who is communicating out-of-band (e.g. via a conversational agent). The slots are recorded against the guest's existing invite/participant record — relaying does not implicitly invite an email that has not already been added to the meeting. Replaces the guest's prior relayed-or-submitted slots (last-write-wins). If the guest has a connected calendar, their real-time free/busy still takes precedence over relayed data per the standard overlap logic.

## Path parameters

- `id` string, required

## Request body

- object
  - `guestEmail` string, email, required: The invited guest's email address. Must match an existing (non-revoked) invite on this meeting.
  - `slots` AvailabilitySlot[], required: Array of availability time slots to record for the guest.
    - `start` string, date-time, required: Slot start time in ISO 8601 format
    - `end` string, date-time, required: Slot end time in ISO 8601 format
    - `isBlocked` boolean: Whether this slot is blocked (calendar event)

## Response `200`

Availability relayed

- object
  - `data` object
    - `saved` boolean

## Other responses

- `400`: Validation error
- `401`: Not authenticated
- `403`: Caller is not the meeting organizer
- `404`: Meeting not found, or guestEmail is not an invited participant
- `429`: Rate limit exceeded. The Retry-After header indicates how many seconds to wait before retrying.

---

[API](https://skmtc.dev/wondercal/apis/wondercal-api.md) · [All operations](https://skmtc.dev/wondercal/apis/wondercal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wondercal/apis/wondercal-api/revisions/4889176a380f?raw)