For the complete documentation index, see llms.txt.

POST /v1/invitations/link

Create Open Invitation Link

Create an **open** (consumer) share link. Unlike `POST /v1/invitations`, this takes no `invitee_email`: whoever opens the link and signs in with any account accepts it, creating a mutual connection and bidirectional `booking:propose` consent (first-acceptor-wins, single-use). JWT user session only (an API key cannot represent human consent). Open to any role. Vennio sends nothing — the caller shares the returned `path` (e.g. `https://when.vennio.app{path}`). A fresh single-use token is minted on every call.

Auth required: Yes

Request Body

• message: string
• venn_link_id: string
• expires_in_days: integer — Days until the link expires. Defaults to 30.

Responses

• 201: Open invitation link created
• 401: Authentication required or invalid
• 403: A user session is required (API keys cannot mint open links).
• 429: Too many requests

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