For the complete documentation index, see llms.txt.

POST /v1/me/role

Set Role At Onboarding

Sets the signed-in user's role once, at onboarding. Accepts only `business` or `customer`, and only while the account has no role. Sending the role the account already has returns it unchanged; sending a different one returns `409`. Signed-in sessions (JWT) only. API keys and connected-app tokens get `403`.

Auth required: Yes

Request Body

• role: string (required) — The role to set.

Responses

• 200: The account's role
• 400: Validation error
• 401: Authentication required or invalid
• 403: Authenticated but insufficient permissions
• 409: Resource conflict

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