For the complete documentation index, see llms.txt.

GET /v1/principals/{principalId}/availability

Get Principal Availability

Get normalized availability blocks for a principal (calendar owner). **Use Case**: Find mutual free time for scheduling across calendars. Requires consent from the principal or API key with appropriate access.

Auth required: Yes

Parameters

• principalId (path, string) (required) — Principal (calendar owner) UUID
• from (query, string) — Start of date range (ISO 8601)
• to (query, string) — End of date range (ISO 8601)
• duration_minutes (query, integer) — Filter blocks by minimum duration

Responses

• 200: Availability blocks
• 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