For the complete documentation index, see llms.txt.

GET /v1/availability/mutual

Find Mutual Availability

Find overlapping free time across 2-5 principals (calendar owners). **Use Case**: Schedule a meeting with multiple attendees by finding times when all participants are available. Requires valid consent from each principal granting the authenticated caller access to their availability. Each principal must have an active consent granting the caller at least `availability:read:freebusy` scope. The response includes a `consents` array proving authorization from each participant.

Auth required: Yes

Parameters

• principal_ids (query, array) (required) — Principal UUIDs whose availability will be intersected. Pass as comma-separated: ?principal_ids=uuid1,uuid2,uuid3
• duration_minutes (query, integer) (required) — Minimum meeting duration in minutes
• from (query, string) (required) — Start of search window (ISO 8601)
• to (query, string) (required) — End of search window (ISO 8601)
• timezone (query, string) — Timezone for results (IANA format)
• limit (query, integer) — Maximum number of slots to return

Responses

• 200: Mutual availability slots
• 400: Validation error
• 401: Authentication required or invalid
• 403: Authenticated but insufficient permissions
• 404: Resource not found

Authentication

Requires authentication. Pass a Bearer token (Supabase JWT) or an API key (`Authorization: Bearer vennio_sk_live_*`) in the request headers.

Base URL: https://api.vennio.app