API Reference
ChatChannel
Manage chat channels and members.
Type Definitions
graphql
type Mutation {
acceptChatChannelInvite(id: ID!): Boolean!
addChatChannelMember(id: ID!, peerId: ID!): ChatChannel!
createChatChannel(name: String!): ChatChannel!
declineChatChannelInvite(id: ID!): Boolean!
deleteChatChannel(id: ID!): Boolean!
leaveChatChannel(id: ID!): Boolean!
removeChatChannelMember(id: ID!, peerId: ID!): ChatChannel!
updateChatChannel(id: ID!, name: String!): ChatChannel!
}
type Query {
chatChannels: [ChatChannel!]!
}
type Subscription {
channelsChanged: ChannelChange!
}
type ChannelChange {
changed: Boolean!
invite: ChannelInvite
cancel: ChannelInviteCancellation
}
type ChannelInvite {
channelId: ID!
channelName: String!
ownerPeerId: ID!
ownerPeerName: String!
}
type ChannelInviteCancellation {
channelId: ID!
ownerPeerId: ID!
}
enum ChannelMemberStatus {
JOINED
PENDING
}
type ChatChannel {
actions: ChatChannelActions!
id: ID!
ownerId: ID!
name: String!
members: [ChatChannelMember!]!
version: Long!
status: ChatChannelStatus!
createdAt: Instant!
updatedAt: Instant!
key: String!
}
type ChatChannelActions {
isOwner: Boolean!
canRename: Boolean!
canManageMembers: Boolean!
canLeave: Boolean!
canDelete: Boolean!
}
type ChatChannelMember {
peerId: ID!
status: ChannelMemberStatus!
}
enum ChatChannelStatus {
JOINED
LEFT
KICKED
}
scalar Instant
scalar LongOperations
mutation
acceptChatChannelInvite
Accept an invitation to join a channel you were invited to.
graphql
mutation acceptChatChannelInvite($id: ID!) {
acceptChatChannelInvite(id: $id)
}mutation
addChatChannelMember
Invite a peer into a channel you own.
graphql
mutation addChatChannelMember($id: ID!, $peerId: ID!) {
addChatChannelMember(id: $id, peerId: $peerId) { id ownerId name version status createdAt updatedAt key }
}mutation
createChatChannel
Create a new encrypted channel owned by this device.
graphql
mutation createChatChannel($name: String!) {
createChatChannel(name: $name) { id ownerId name version status createdAt updatedAt key }
}mutation
declineChatChannelInvite
Decline a pending channel invitation.
graphql
mutation declineChatChannelInvite($id: ID!) {
declineChatChannelInvite(id: $id)
}mutation
deleteChatChannel
Delete a channel and all its messages.
graphql
mutation deleteChatChannel($id: ID!) {
deleteChatChannel(id: $id)
}mutation
leaveChatChannel
Leave a channel you do not own.
graphql
mutation leaveChatChannel($id: ID!) {
leaveChatChannel(id: $id)
}mutation
removeChatChannelMember
Remove a member from a channel you own.
graphql
mutation removeChatChannelMember($id: ID!, $peerId: ID!) {
removeChatChannelMember(id: $id, peerId: $peerId) { id ownerId name version status createdAt updatedAt key }
}mutation
updateChatChannel
Rename a chat channel.
graphql
mutation updateChatChannel($id: ID!, $name: String!) {
updateChatChannel(id: $id, name: $name) { id ownerId name version status createdAt updatedAt key }
}query
chatChannels
List all chat channels owned or joined by the device.
graphql
query chatChannels {
chatChannels { id ownerId name version status createdAt updatedAt key }
}subscription
channelsChanged
Receive chat-channel change information.
graphql
subscription channelsChanged {
channelsChanged { changed }
}