v3

latestOpenAPI 3.0.0Dex Terms of Service2026-07-311481984.7 KB
groups

Create a group (v2)

Create ONE group. Accepts name, emoji, description, parent_id (for nested groups), and an optional groups_contacts array to add starter members. Requires Idempotency-Key. Returns { data: { group: {...} } } with status 201.

post/v2/groups/

Headers

Idempotency-Keystring required
Example:01HV8N6X7K3P9Q5R2T4Y6W8Z0A

Required. UUID per logical operation, reused on every retry. See apps/rest-api/src/shared/idempotency.ts for the full contract. Missing → 400 BadRequest; same key + different body → 409 Conflict.

Request body

Response

Created