Skip to content

Channel

A Channel is a place Messages flow, such as a chat channel, a Mailbox, or an SMS number.

Properties

PropertyTypeRequiredDescription
mediumstringrequiredThe platform type, such as email, sms, or chat.
organizationOrganizationThe outside Organization the Channel is shared with; its new Messages open Conversations for that Customer.
externalbooleanTrue when people from another Organization post in it, as in a channel two companies share.
areaCodestringFor an sms Channel, the phone area code its number is drawn from, such as 512.
numberstringFor an sms Channel, its phone number in international form, assigned when it is created.

Object

JSON
{
  "$id": "https://api.sb/routewise.dev/channels/channel_1",
  "$type": "Channel",
  "medium": "email",
  "organization": "organization_1",
  "external": true,
  "areaCode": "Example area code",
  "number": "Example number"
}

Relationships

Verbs

  1. createCreates a Channel.
    POST /{namespace}/channelsdoChannel.created
  2. getReturns one Channel by id.
    GET /{namespace}/channels/{id}readNo Event
  3. listReturns Channels, newest first, one page at a time.
    GET /{namespace}/channelsreadNo Event
  4. updateChanges the given properties of a Channel.
    PATCH /{namespace}/channels/{id}doChannel.updated
  5. deleteDeletes a Channel; its history is kept.
    DELETE /{namespace}/channels/{id}doChannel.deleted

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Channel.createYesYesYesNo
Channel.getYesYesYesYes
Channel.listYesYesYesYes
Channel.updateYesYesYesNo
Channel.deleteYesYesYesNo

Call it

Text
Add a channel to LedgerLark.

Example

A tutoring marketplace runs three Channels: the help@ Mailbox, one chat channel per family and its tutor, and an SMS number for session reminders.