Actions60
- User Actions
- Channel Actions
- Accept Invite
- Add Members
- Add Moderators
- Archive
- Ban User
- Create
- Delete
- Delete File
- Delete Image
- Demote Moderators
- Disable Slow Mode
- Enable Slow Mode
- Get Config
- Hide
- Invite Members
- Mark Read
- Mark Unread
- Mute
- Mute Status
- Pin
- Query Channels
- Query Members
- Reject Invite
- Remove Members
- Send Action
- Send File
- Send Image
- Show
- Stop Watching
- Truncate
- Unarchive
- Unban User
- Unmute
- Unpin
- Update
- Watch
- Message Actions
- Moderation Actions
Overview
The "Stop Watching" operation for the Channel resource in this node allows users to stop actively watching a specific chat channel on the Stream Chat platform. Watching a channel typically means subscribing to real-time updates such as new messages or events within that channel. Stopping watching will unsubscribe the user or client from these live updates, which can be useful to reduce unnecessary data flow or to manage resource usage.
Common scenarios where this is beneficial:
- When a user leaves a chat or no longer needs to receive live updates from a particular channel.
- To optimize performance by unsubscribing from channels that are not currently relevant.
- Managing multiple channels and dynamically controlling which ones are actively monitored.
Practical example:
- A team collaboration app where users join various project channels. When a user finishes work on a project, the app calls "Stop Watching" on that channel to stop receiving notifications and updates related to it.
Properties
| Name | Meaning |
|---|---|
| Channel Type | The type of the channel. Common types include: "messaging" (1-on-1 chats), "team" (group channels), "livestream" (broadcast channels). |
| Channel ID | Unique identifier for the channel (e.g., "general", "random", "team-alpha"). Combined with Channel Type to form the full channel identifier (CID). |
Output
The output JSON contains the response from the Stream Chat API after attempting to stop watching the specified channel. This typically includes confirmation details about the unsubscription status or any relevant metadata returned by the API.
No binary data is involved in this operation.
Dependencies
- Requires an active connection to the Stream Chat service via an API key credential configured in n8n.
- The node uses the Stream Chat server-side client SDK to perform operations.
- Proper permissions must be granted to the API credentials to allow stopping watching channels.
Troubleshooting
Common issues:
- Providing an invalid or non-existent Channel ID or Channel Type may result in errors.
- Insufficient permissions on the API key can cause authorization failures.
- Network connectivity issues can prevent communication with the Stream Chat API.
Common error messages:
"Unsupported operation: channel.stopWatching": Indicates the operation is not recognized; ensure the correct Resource and Operation are selected.- Errors related to invalid channel identifiers or missing parameters: Verify that both Channel Type and Channel ID are correctly set.
- Authorization errors: Check that the API key credential has the necessary permissions.
Resolution tips:
- Double-check input parameters for typos or incorrect values.
- Confirm API credentials and their permissions.
- Review network settings and retry if transient errors occur.