For the complete documentation index, see llms.txt.

POST /v1/proposals

Create Proposal

Create a new multi-party meeting proposal. Sends proposed time slots to one or more participants who can accept, counter, or reject. The authenticated user is automatically added as the organizer.

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

• participant_ids: array (required) — UUIDs of the participants to include (1-10)
• slots: array (required) — Proposed time slots (1-10)
• message: string
• metadata: object — Extensible metadata (service_type, duration_minutes, price, etc.)
• expires_in_hours: integer — Hours until the proposal expires

Responses

• 201: Proposal created
• 400: Validation error
• 401: Authentication required or invalid
• 409: A request with this Idempotency-Key is currently being processed
• 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