Skip to main content
← All documentation

Spaces and channels

Core concepts

An organization holds spaces. A space holds channels, optionally grouped into categories. A space has a type, and the type decides which product surface renders it: work and partner spaces are Kemble Work, community and circle spaces are Kemble Circle.

Channel types

  • text — the ordinary conversation channel.
  • announcement — readable by everyone in the space, postable only by people who can manage the channel.
  • voice — a voice room, mesh below the plan threshold and an SFU above it.
  • stage — a voice room where speaking is a separate permission from connecting, so an audience listens without publishing.

Managing them

  • POST /api/spaces/:space/channels — create.
  • PATCH /api/channels/:channel — rename, re-topic, archive, make private.
  • PUT /api/channels/:channel/category — move between categories in the same space.
  • POST /api/spaces/:space/categories/reorder — reorder, sending the complete ordering.