List email groups

GET 
/api/v1/email-groups

Lists the owner's email groups (reusable email allow-lists shared across their chatbots). Pass includeUsage=true to include how many documents use each group. Email groups are OWNER-scoped, not per-chatbot: a key restricted to specific chatbots still has full access to all of the owner's email groups. Required scope: security:read.

Request

Responses

200

The owner's email groups.

401

Unauthorized — missing or invalid API key

403

Forbidden — key lacks required scope

429

Too Many Requests — rate limit exceeded