Stream Chat icon

Stream Chat

Server-side Stream Chat operations

Overview

This node enables server-side management of Stream Chat channels, including the ability to delete images uploaded to a channel. The "Delete Image" operation specifically removes an image from a specified channel by providing its URL.

Common scenarios for this operation include:

  • Moderating content by removing inappropriate or outdated images from chat channels.
  • Managing storage and cleanup by deleting unused or obsolete images.
  • Automating channel maintenance workflows where images need to be programmatically removed based on certain triggers.

For example, you might use this node to delete a promotional image from a team channel after a campaign ends or remove user-uploaded images flagged as inappropriate.

Properties

Name Meaning
Channel Type The type of the channel. Common options: "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 type to form the channel CID. Required.
File URL The URL of the image file to delete from the channel. Required.

Output

The output is a JSON object representing the result of the delete image operation. It typically contains confirmation details or status information returned by the Stream Chat API about the deletion.

No binary data is output by this operation.

Example output structure (simplified):

{
  "deleted": true,
  "file_url": "https://example.com/path/to/image.jpg"
}

Dependencies

  • Requires an API key credential for authenticating with the Stream Chat service.
  • The node uses the Stream Chat server-side client library to perform operations.
  • Proper permissions must be granted to the API key to allow deleting images in channels.

Troubleshooting

  • Error: Unsupported operation — This indicates that the selected resource-operation combination is not implemented. Ensure you have chosen "Channel" as the resource and "Delete Image" as the operation.
  • Invalid Channel ID or Channel Type — Make sure the channel type and ID are correct and correspond to an existing channel.
  • File URL not found or invalid — Verify that the file URL points to an existing image in the channel.
  • Permission errors — Confirm that your API credentials have sufficient rights to delete images in the specified channel.
  • Network or API errors — Check connectivity and Stream Chat service status.

To resolve errors, verify input parameters, check API credentials, and consult Stream Chat API documentation for permission requirements.

Links and References

Discussion