For the complete documentation index, see llms.txt.

POST /v1/hosts

Provision Host

Create a new managed host principal under the authenticated account. Returns the host's `principal_id`. Connect the host's calendar next via `POST /v1/hosts/{id}/connect-link`.

Auth required: Yes

Request Body

• display_name: string (required) — The host's display name (e.g. the coach's name).

Responses

• 201: Host provisioned

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