> For the complete documentation index, see [llms.txt](https://doc.wearepatchworks.com/product-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/connector-shape/configuring-sftp-connections/valid-ftp-commands/pluck-ftp-command.md). # pluck (FTP command) ### Overview The `pluck` command retrieves a file, loads content into the process flow as a payload, and then deletes the file from the remote server. ## Need to know * You can pluck a single file or multiple files. * Regular expressions are supported when defining files to retrieve with the `get` command. ## Connection settings When [configuring an SFTP connector](/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/connector-shape/configuring-sftp-connections.md), two fields should be updated: | FTP command | Root | Path | | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | | FTP command only: `pluck` |

The root to the file(s) you want to pluck.

Since the root only applies to one directory, you can enter the full path here.

| The filename(s) to be plucked. | ## Example * [Scenario](#scenario) * [The steps](#the-steps) ### Scenario
Cover image

Our process flow is configured as follows:

/files/rI8jPerjv9MFfSCvdBbq
In this flow, we need to pluck all files in /myfiles/folderB that start with orders - so orders.json, orders2.json, orders3.json:

/files/2vpVY6Q37YrYqTgeZirK
### The steps
Cover image

Connector settings

Our SFTP shape is configured as follows:

  • Use the SFTP GET user pass endpoint.
  • Start looking for the file to rename from the root, which is defined as: /myfiles/folderB/
  • Check the path for the file(s) to pluck, which is defined as: /^orders.*/i. This regular expression resolves to 'all files starting with 'orders', irrespective of upper/lower case.
/files/oMb9sRQ3X0NcUlY4i8Mk

Payload & SFTP server

When the process flow is run, the payload for the SFTP shape shows the content retrieved from matched files. We have three payloads:

On our remote server, all 'orders' files have been removed from /myfiles/folderB/ and this directory is now empty:

/files/J6YFhcQQMgUmK2sBQwdu