WuKongIM Docs

Create or update Channel metadata

Operation boundary

  • Caller: Trusted backend only
  • Scope: Channel metadata and membership are written to cluster storage; large is recomputed from the current member count after membership changes.
  • Atomicity: Metadata update, old-member removal, chunked member insertion, and large refresh are separate stages, not one transaction.
  • Recovery: After a timeout or 400/5xx, replay the desired business state and verify membership through the protected Manager query.
POST/channel

Upserts all metadata flags and optionally resets subscribers; disband is terminal.

Request Body

application/json

Channel metadata to create or update plus an optional subscriber snapshot.

TypeScript Definitions

Use the request body type in TypeScript.

Full Channel metadata update plus optional subscriber replacement parameters.

Response Body

application/json

application/json

application/json

{  "status": 200}