Channels
A Channel is how people are brought into collaboration around Spaces.
- A channel is connected to Spaces that its owner can access (
GET/PUT .../{channelId}/spaces) - Members join via invites; they converse via channel comments
- Through the channel, users query Space data using Modules connected to those Spaces (today: Tags; more modules later)
Create and list channels via /v0/channels.
| Area | Endpoints |
|---|---|
| Members | GET / DELETE .../{channelId}/members |
| Invites | create / cancel / pending inbox / respond |
| Connected spaces | GET / PUT .../{channelId}/spaces (replace-all) |
| Comments | GET / POST .../{channelId}/comments |
Rule of thumb: Spaces hold the data; Channels organise people and conversation, and expose module-backed queries over that data.
Discussion can also be attached directly to a Space. See Comments. Tags are a module, not a synonym for comments — see Tags and Modules overview.