For the complete documentation index, see llms.txt.

POST /v1/teams/{id}/proposals

Create Team Proposal

Create a consensus-based proposal from the team's schedulable members. All schedulable members become proposal participants. Email-only members are excluded from consensus and will be invited after acceptance. Optionally provide `override_members` to use a custom participant roster.

Auth required: Yes

Parameters

• id (path, string) (required)
• 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

• slots: array (required)
• message: string
• expires_in_hours: integer
• override_members: array — Custom participant user_ids (overrides team roster)

Responses

• 201: Proposal created
• 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