For the complete documentation index, see llms.txt.

POST /v1/invitations

Send Invitation

Create and send a stakeholder invitation. Sends an email to the invitee with a link to accept/decline.

Auth required: Yes

Parameters

• Idempotency-Key (header, string) — Unique key for idempotent POST requests (1-256 chars: alphanumeric, `_`, `-`, `:`, `.`). Same key + same body within 24h replays the cached response.

Request Body

• invitee_email: string (required)
• invitee_name: string
• relationship_type: string (required)
• venn_link_id: string
• message: string

Responses

• 201: Invitation created and sent
• 400: Validation error
• 401: Authentication required or invalid
• 409: Resource conflict
• 422: Idempotency-Key was already used with a different request body

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