For the complete documentation index, see llms.txt.

POST /v1/proposals/{id}/response

Respond to Proposal

Accept, counter, or reject a proposal. - **accept**: Requires `selected_slot_id`. Proposal transitions to `accepted` when ALL required participants accept. - **counter**: Requires `counter_slots`. Current proposal transitions to `countered`, a new proposal is created in the same thread. - **reject**: Any required participant rejecting transitions the whole proposal to `rejected`.

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

• action: string (required)
• selected_slot_id: string — Required for accept action — ID of the slot to select
• counter_slots: array — Required for counter action
• message: string

Responses

• 200: Response recorded
• 400: Validation error
• 401: Authentication required or invalid
• 404: Resource not found
• 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