PATCH /automation/v1/fileTransfers/{FileTransferId}/

Update an existing File Transfer Activity definition.

NAMETYPEDESCRIPTION
IDguidUnique identifier of the file transfer activity.
NamestringName of the file transfer activity.
DescriptionstringDescription of the file transfer activity.
CustomerKeystringClient-specified unique identifier of the file transfer activity.
FileSpecstringName of the file that will be used in the File Transfer Activity.
IsEncryptedboolIndicates whether the File Transfer Activity will perform encryption/decryption.
IsCompressedboolIndicates whether the File Transfer Activity will perform compression/decompression.
MaxFileAgenumberMaximum age of a file in hours that can be processed by the File Transfer Activity. If the file is older than this number of hours, an Invalid File Age error will occur. Set to 0 to disable this guardrail.
MaxFileAgeScheduleOffsetnumberMaximum delay in hours that can be tolerated for processing the file. If the activity takes longer than this timespan to process the file, an Invalid File Age error will occur. Set to 0 to disable this guardrail.
MaxImportFrequencynumberMinimum number of hours required between runs of this File Transfer Activity. If an instance of the File Transfer Activity attempts to run sooner than the specified number of hours, that instance will fail. Set to 0 to disable this guardrail.
FileTransferLocationIDguidUnique identifier of the file transfer location that holds the file. This can be retrieved from the /automations/v1/ftpLocations route.
IsUploadboolValid values are true/false. This indicates whether data is coming in or out. For activities that transfer files, true causes the file to be uploaded to the file transfer location, and false causes the file to be downloaded from the file transfer location. If IsEncrypted is set, then true will trigger encryption, and false will trigger decryption. If IsCompressed is set, then true will trigger compression, and false will trigger decompression.
IsPgpboolSet this value to true to use asymmetric encryption. False will cause the File Transfer Activity to run with symmetric encryption.
IsFileSpecLocalizedboolDetermines if the time should be localized when using file naming patterns like %%Hour%% in the FileSpec property.
PublicKeyManagementIdnumberWhen using an encryption key loaded in Public Key Management, use this ID to specify the key to use.
CreatedDatedateTimestamp when the file transfer activity was created. Set to null for creating a new activity.
ModifiedDatedateTimestamp when the file transfer activity was last modified. Set to null for creating a new activity.
STATUSNAMETYPEDESCRIPTION
200OK
IDguidUnique identifier of the file transfer activity.
NamestringName of the file transfer activity.
CustomerKeystringClient-specified unique identifier of the file transfer activity.
FileSpecstringName of the file that will be used in the File Transfer Activity.
IsEncryptedboolIndicates whether the File Transfer Activity will perform encryption/decryption.
IsCompressedboolIndicates whether the File Transfer Activity will perform compression/decompression.
MaxFileAgenumberMaximum age of a file in hours that can be processed by the File Transfer Activity. If the file is older than this number of hours, an Invalid File Age error will occur. Set to 0 to disable this guardrail.
MaxFileAgeScheduleOffsetnumberMaximum delay in hours that can be tolerated for processing the file. If the activity takes longer than this timespan to process the file, an Invalid File Age error will occur. Set to 0 to disable this guardrail.
MaxImportFrequencynumberMinimum number of hours required between runs of this File Transfer Activity. If an instance of the File Transfer Activity attempts to run sooner than the specified number of hours, that instance will fail. Set to 0 to disable this guardrail.
FileTransferLocationIdguidUnique identifier of the file transfer location that holds the file. This can be retrieved from the /automations/v1/ftpLocations route.
IsUploadboolValid values are true/false. This indicates whether data is coming in or out. For activities that transfer files, true causes the file to be uploaded to the file transfer location, and false causes the file to be downloaded from the file transfer location. If IsEncrypted is set, then true will trigger encryption, and false will trigger decryption. If IsCompressed is set, then true will trigger compression, and false will trigger decompression.
IsPgpboolSet this value to true to use asymmetric encryption. False will cause the File Transfer Activity to run with symmetric encryption.
PublicKeyManagementIdnumberWhen using an encryption key loaded in Public Key Management, use this ID to specify the key to use.
IsFileSpecLocalizedboolDetermines if the time should be localized when using file naming patterns like %%Hour%% in the FileSpec property.
CreatedDatedateTimestamp when the file transfer activity was created.
ModifiedDatedateTimestamp when the file transfer activity was last modified.
400Bad Request
MessagestringThe value specified for the following field is not valid: 'publicKeyManagementId'.
Note: If you encounter this error, please ensure the publicKeyManagementId corresponds to a valid key in Public Key Management._
400Bad Request
MessagestringThe value specified for the following field is not valid: 'fileTransferLocationId'.
Note: If you encounter this error, please ensure the fileTransferLocationId corresponds to a valid key in File Transfer Locations._
403Unauthorized
MessagestringInsufficient privileges
500Error
ErrorCodenumber10000