MuleSoft · SFTP Connector

SFTP:ILLEGAL_PATH

Short answer

SFTP:ILLEGAL_PATH means the path given to the SFTP operation is invalid, for example because it does not exist. Correct the path, or create the directory on the server first.

VerifiedLast verified

01Error text

MuleSoft error
Error type: SFTP:ILLEGAL_PATH

02Likely causes

  • The specified path is invalid because, for example, it does not exist.

03How to fix it

  1. Check the path the operation receives at run time, including any expression that builds it.
  2. Reproduce the problem with an SFTP client such as Cyberduck or FileZilla, using the same host, port and user. Confirm the path exists for that user.
  3. Turn on verbose logging: in log4j2.xml add <AsyncLogger name="org.mule.extension.sftp" level="DEBUG"/>. For SSH detail add <AsyncLogger name="org.apache.sshd" level="TRACE"/>, which produces a high log volume, so remove it afterward.
  4. Handle the failure with an error handler of type SFTP:ILLEGAL_PATH.

04Official documentation

Test every fix in a non-production environment before you apply it to production. See how entries are verified.

More for MuleSoft work:Open MuleSoft jobsMuleSoft rates and salariesHire a senior MuleSoft developer

The iPaaS Brief

Subscribe to The iPaaS Brief.

The iPaaS newsletter for the people who run integrations. From iPaaS Group.

Free. You finish on theipaasbrief.com and confirm by email.