For the complete documentation index, see llms.txt.

POST /v1/teams

Create Team

Create a new persistent team. The authenticated user becomes the team owner. Optionally include initial members in the request body.

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

• name: string (required)
• description: string
• members: array — Initial members to add. Each must have either `user_id` or both `email` and `name`.

Responses

• 201: Team created
• 400: Validation error
• 401: Authentication required or invalid

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