Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this article

...

Use this Snap to delete a file sent to user/group/channel in the Slack workspace.

Prerequisites

A valid and active account in the Slack workspace.

...

Add valid Slack Scopes based on the intended operation. See Required Slack Scopes below for details.

Required Slack Scopes

Any action you want to perform within a Slack workspace, additionally needs appropriate Scopes assigned to your appSee the Scope and Permissions article in Slack API documentation for the complete list and each Account page under Configuring Slack Accounts for information on defining Scopes for your app.

...

Input/OutputType of ViewNumber of ViewsExamples of Upstream and Downstream SnapsDescription
Input 

Document

  • Min: 0
  • Max: 1
  • Mapper
  • Copy
  • JSON Generator
A document containing the file ID of the file to be deleted.
Output

Document

  • Min: 0
  • Max: 1
  • Mapper
  • JSON Formatter

A document containing the success/failure status of each file deleted.

Snap Settings

Parameter NameData TypeDescriptionDefault ValueExample 
LabelString
Insert excerpt
File Writer
File Writer
nopaneltrue
Delete FileDelete File
File ID

String/Expression/Suggestion

Required. Use the Suggestions list to select the file to be deleted from the list of files currently available in the workspace.N/ACar.jpeg:F018U1KCA0N
Snap ExecutionDrop-down list

Select one of the three following modes in which the Snap executes:

  • Validate & Execute. Performs limited execution of the Snap and generates a data preview during Pipeline validation, then performs full execution of the Snap (unlimited records) during Pipeline runtime.
  • Execute only. Performs full execution of the Snap during Pipeline execution without generating preview data.
  • Disabled. Disables the Snap and all Snaps downstream from it.

Execute onlyValidate & Execute

...

ErrorReasonResolution

Failure: Unable to delete the file for given ID, Reason: file_deleted

The file you specified for deletion is already deleted.

Ensure that the file you choose for deletion exists within your Slack instance, before running the Snap/Pipeline.

Examples

Uploading and Deleting Files

...

This example demonstrates how we can use the Upload File Snap to share files with one or more recipients. To delete a file that you have sent to another Slack user/Channel/private group, you need to use the Delete File Snap to pass the id of the file to be deleted. The same can be done for multiple files, at once.

In this example, we use the Upload File Snap to upload and share a file with members of a Channel. 

...