Create a new channel

Create a new channel. A maximum of 100 channels can be created per account per day. The maximum request size is 10MB.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringRequired
The name of the channel
descriptionstringRequired
A description of the channel
modalityenumRequired
The modality of the channel
Allowed values:
metadatamap from strings to strings or booleans or doublesOptional

A dictionary of key, value pairs assigned to the channel. Metadata may not exceed 4KB total

  • metadata keys may only be of type: string
  • metadata values may only be one of type: string, boolean, or number

Response

Channel created
namestring
The name of the channel
descriptionstring
A description of the channel
modalityenum
The modality of the channel
Allowed values:
idstring or nullformat: "id"
The channel ID
metadatamap from strings to strings or booleans or doubles or null

A dictionary of key, value pairs assigned to the channel. Metadata may not exceed 4KB total

  • metadata keys may only be of type: string
  • metadata values may only be one of type: string, boolean, or number
created_atstring or nullformat: "date-time"
The date and time the channel was created

Errors