Overview

There are a number of parameters within a job that can only be set when the job is first created (i.e. source/destination connections and paths). The ability to duplicate a job allows you to copy a job and override parameters of the "new" job.

REST API

Jobs can be duplicated through the REST API. The request can optionally include a JSON body that overrides the parameters within the source job. The request must include an appropriate Authorization header with a valid access token. An example request and response is found below.

Content-Type: application/json

Example Clone Job

This example clone job will change the values for lock propagation, permissions, version preservation, and the schedule.

{
    "name": "Clone Job",
    "transfer": {
    "transfer_type": "copy",
      "lock_propagation": "ignore",
      "permissions": {
    		"policy": "none",
    		"links": true,
    		"failures": "none"
      },
      "versioning": {
    		"preserve": "native",
    		"select": "all"
      }
    },
    "schedule": {
        "mode": "manual"
    }
}

Delete or Disable Original Job

When cloning a job, you want to ensure you either delete the original job or at least remove the job schedule so you do not encounter transfer conflicts. 

DELETE {{url}}v1/jobs/{{original_job_id}}

Modify Job Schedule

{
    "kind": "transfer",
    "transfer_type": "copy",
    "schedule": {
        "mode": "manual"
    }
}