Skip to main content
Version: Current

Delete File

Description​

Deletes a file from a remote SFTP server.

The file can be identified using either a File Reference or a remote file path.

The activity returns a boolean indicating whether the file was successfully deleted, allowing downstream logic to handle scenarios where the file does not exist.

Common Capabilities​

Process Data Support​

info

This activity supports dynamic configuration using variables from the Process Data drawer.

You can bind values from Model Data, Form Data, System Data, Enterprise Variables, and Activity Outputs.

Learn more → Using Process Data

Design-Time Configuration​

Connection Name​

The name of the configured SFTP connection used to authenticate with the remote server.

If no connection exists, click Add Connection to create one inline.

Learn more → SFTP Connection

File​

The file to delete.

You can provide either:

  • A File Reference returned by a previous activity.
  • A Remote Path identifying the file on the SFTP server.

Examples:

  • /reports/january.csv
  • /archive/2024/report.xlsx

When a remote path is used, you can browse the remote directory structure using the path browser, which connects through the selected SFTP connection.

Ignore If Not Exists​

When enabled, the activity completes successfully even if the file does not exist. In this case, the Deleted output is set to false.

When disabled, the activity faults if the file cannot be found.

Defaults to off.

Wait All Incoming​

Execution Control

Controls how this activity behaves when multiple incoming execution paths converge.

Determines whether the activity executes when:

  • any incoming path completes, or
  • all relevant paths have completed before execution

Learn more → Execution Control

On Error​

Error Handling Strategy

Defines how the workflow behaves if this activity encounters a runtime error.

Supported strategies include Fault, Continue, Suspend, and Retry.

Learn more → Error Handling

Output​

Deleted​

Indicates whether the file was successfully deleted.

ValueMeaning
trueThe file existed and was successfully deleted.
falseThe file did not exist and Ignore If Not Exists was enabled.

Remarks​

  • Deleting a file permanently removes it from the SFTP server.
  • The activity does not move files to a recycle bin or recovery location.
  • If the target file is locked or access is denied by the SFTP server, the activity faults unless handled through the configured error strategy.