# 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
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET 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?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.