API - Channel Routes

Source of truth: d3chat/backend/app/routers/channels.py

Prefix: /api/v1/channels

All routes below require Bearer auth.

`POST /channels`

Creates channel and owner membership.

Request:

{
  "name": "engineering",
  "is_dm": false,
  "encryption_type": "sender_keys"
}

Lists channels where current user is a member.

Returns channel metadata for members only.

Updates mutable fields (currently name).

Deletes channel. Requires owner membership role.

Adds current user as member if not already joined.

Removes current user membership.

Lists channel members with username/domain/role/profile metadata.

Adds a member by user ID.

Request:

{ "user_id": "<uuid>" }

Behavior:

rejects DMs (400)
rejects duplicate membership (409)
if target is remote user (is_local=false):
- marks channel federated
- relays channel.invite event
publishes channel.new to added user via Redis

Creates or returns existing DM between current user and target user.

Request:

{ "user_id": "<target-user-uuid>" }

Behavior: