{"_id":"5964f171895d4e0015963281","project":"55faf11ba62ba1170021a9a7","version":{"_id":"55faf11ba62ba1170021a9aa","project":"55faf11ba62ba1170021a9a7","__v":38,"createdAt":"2015-09-17T16:58:03.490Z","releaseDate":"2015-09-17T16:58:03.490Z","categories":["55faf11ca62ba1170021a9ab","55faf8f4d0e22017005b8272","55faf91aa62ba1170021a9b5","55faf929a8a7770d00c2c0bd","55faf932a8a7770d00c2c0bf","55faf94b17b9d00d00969f47","55faf958d0e22017005b8274","55faf95fa8a7770d00c2c0c0","55faf96917b9d00d00969f48","55faf970a8a7770d00c2c0c1","55faf98c825d5f19001fa3a6","55faf99aa62ba1170021a9b8","55faf99fa62ba1170021a9b9","55faf9aa17b9d00d00969f49","55faf9b6a8a7770d00c2c0c3","55faf9bda62ba1170021a9ba","5604570090ee490d00440551","5637e8b2fbe1c50d008cb078","5649bb624fa1460d00780add","5671974d1b6b730d008b4823","5671979d60c8e70d006c9760","568e8eef70ca1f0d0035808e","56d0a2081ecc471500f1795e","56d4a0adde40c70b00823ea3","56d96b03dd90610b00270849","56fbb83d8f21c817002af880","573c811bee2b3b2200422be1","576bc92afb62dd20001cda85","5771811e27a5c20e00030dcd","5785191af3a10c0e009b75b0","57bdf84d5d48411900cd8dc0","57ff5c5dc135231700aed806","5804caf792398f0f00e77521","58458b4fba4f1c0f009692bb","586d3c287c6b5b2300c05055","58ef66d88646742f009a0216","58f5d52d7891630f00fe4e77","59a555bccdbd85001bfb1442"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"55faf9aa17b9d00d00969f49","pages":["56312d239ead230d00a188f2","56312e0d82d96a0d00b0fb08","56315777fc94aa0d00e9b553","56315b779ead230d00a1894a","5631657c9c25801700dac34f","56317884fc94aa0d00e9b586","56318386c3b04b0d00ba9bb9","563240ccdcc27a170082363b","563240dfbddb091700ad5e82","563240edfe9acd1900cc1d10","56324504fa40240d007c8d5f","56324b30c3b04b0d00ba9c96","563273ae45f2cb0d006be3fa","563273c08c9cda0d0025266d","563273cc38f8aa0d00d30f55","563273d838f8aa0d00d30f59","5632740945f2cb0d006be3fc","56327411df556c0d00cd0905","5632741b8c9cda0d0025266f","563274ea10b6040d008793d8","5632757cdf556c0d00cd0908","563275b710b6040d008793da","563275f938f8aa0d00d30f60","5632762fb904a10d0032f6fc","5632767110b6040d008793dd","563276c0b904a10d0032f700","5632770162c48a0d00334d53","5632843d8c9cda0d00252698","5632846e62c48a0d00334d78","56328a7e49e16d0d00122420","56328aaf49e16d0d00122425","56328b2238f8aa0d00d30f88","56328b6c8c9cda0d002526a2","56328c0710b6040d008793ff","56328c3710b6040d00879401","56328c5938f8aa0d00d30f8c","56328c90b904a10d0032f722","56328cc449e16d0d0012242a","56328ce68c9cda0d002526a8","56328d1338f8aa0d00d30f8e","56328d5810b6040d00879407","56328d7cdf556c0d00cd092f","56328d9a10b6040d00879409","56328db438f8aa0d00d30f92","56328dd762c48a0d00334d8b","56328df649e16d0d0012242d","56328e1edf556c0d00cd0931","56328e4662c48a0d00334d8e","56328e5edf556c0d00cd0933","56328e8f8c9cda0d002526ab","56328eb3b904a10d0032f72a","56328edb38f8aa0d00d30f95","56328ef210b6040d0087940d","56328f148c9cda0d002526ad","56328f2962c48a0d00334d90","56328f54b904a10d0032f72c","56328f6c38f8aa0d00d30f98","56328f858c9cda0d002526af","56328fae62c48a0d00334d95","56328fd838f8aa0d00d30f9c","5637f069ee0ee60d0024ec18","5641ffaa9417b40d00c0fc35","564355240d9748190079dea9","5644cfeb2c74cf1900da4831","56450f856b0ca50d00f6bd8f","56706537cbb2fb0d00f7c7dd","567065bc3d29830d00376213","56706fc2cbb2fb0d00f7c87e","568bf5a1e662f40d00eee866","568c0699e662f40d00eee881","568cff0274c77f2d00d56d51","568d10f58602880d001ce277","568d2abc37b636250036b904","568d343413c5ad0d00b34efb","568d593a8602880d001ce2d3","568e64135e12fb0d00325160","568e66f05e12fb0d00325162","568e78aa5e12fb0d0032517a","569433cfd8c04d1700e5ae0c","56943723d8c04d1700e5ae14","5694393b3e9d080d00f0655d","5694e6cf953b810d008f91bc","5694f301c5c5ce0d00058e68","569502ef9797fa1900f704e7","5695063bcaa32519009c40b3","569511cccaa32519009c40d9","569557e2fcb1032d0089dfe2","569562fefcb1032d0089dfee","56956428fe18811700c9c058","569639b87596a90d0014e5a3","56a90197e590350d004b5103","56a9021e9ec7660d002e08c2"],"project":"55faf11ba62ba1170021a9a7","version":"55faf11ba62ba1170021a9aa","__v":92,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-09-17T17:34:34.937Z","from_sync":false,"order":27,"slug":"api","title":"API Reference"},"user":"5767bc73bb15f40e00a28777","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-07-11T15:40:33.898Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"method":"post","examples":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":60,"body":"This call synchronizes a copied app with the source app from which it has been copied. For example, when **FASTQC** is copied from public apps to a project and updates are made to **FASTQC** in the public apps gallery (there are new revisions), this action fetches all revisions and revision notes from the updated parent app and applies them to your copied app. Once this has been done, the copied app is updated to the latest revision and includes the complete revision history of its parent app, following the logic of the `git pull` command.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://cgc-api.sbgenomics.com/v2/apps/{app_id}/actions/sync\",\n      \"language\": \"text\",\n      \"name\": \"Path\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"Recall from the [API Overview](http://docs.cancergenomicscloud.org/v1.0/docs/the-cgc-api#section-identifying-projects-users-apps-files-and-tasks) that the `app_id` has the form `{project_owner}/{project}/{app_short_name}/{revision_number}`.\",\n  \"title\": \"app_ids\"\n}\n[/block]\n##Request\n\n###Example request\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST v2/apps/rfranklin/test-project/bamtools-index-2-4-0/actions/sync HTTP/1.1\\nHost: cgc-api.sbgenomics.com\\nX-SBG-Auth-Token: 3259c50e1ac5426ea8f1273259740f74\",\n      \"language\": \"http\",\n      \"name\": null\n    },\n    {\n      \"code\": \"curl --data '{\\\"username\\\": \\\"rfranklin\\\", \\\"permissions\\\": { \\\"read\\\": true, \\\"write\\\": true, \\\"execute\\\": false}}' -s -H \\\"X-SBG-Auth-Token: 3259c50e1ac5426ea8f1273259740f74\\\" -H \\\"content-type: application/json\\\" -X POST \\\"https://cgc-api.sbgenomics.com/v2/apps/rfranklin/test-project/bamtools-index-2-4-0/actions/sync\\\"\",\n      \"language\": \"curl\",\n      \"name\": \"cURL\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]\n###Header Fields\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"`X-SBG-Auth-Token`\\n_required_\",\n    \"0-1\": \"Your CGC [authentication token](doc:get-your-authentication-token).\",\n    \"h-2\": \"\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\n###Path parameters\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"`app_id`\",\n    \"h-0\": \"Name\",\n    \"h-1\": \"Description\",\n    \"0-1\": \"The ID of the app you want to update. It should reference the project owner, the project that your app is copied to, and the app's short name (containing no non-alphanumeric characters or spaces).\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\n###Query parameters\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Data type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"`fields`\",\n    \"0-1\": \"string\",\n    \"0-2\": \"Selector specifying a subset of fields to include in the response.\"\n  },\n  \"cols\": 3,\n  \"rows\": 1\n}\n[/block]\n##Response\n\n[See a list of CGC-specific response codes that may be contained in the body of the response.](doc:api-status-codes)\n\n###Example response body\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"href\\\": \\\"https://cgc-api.sbgenomics.com/v2/apps/rfranklin/test-project/bamtools-index-2-4-0/1\\\",\\n  \\\"id\\\": \\\"rfranklin/test-project/bamtools-index-2-4-0/1\\\",\\n  \\\"project\\\": \\\"rfranklin/test-project\\\",\\n  \\\"name\\\": \\\"BamTools Index\\\",\\n  \\\"revision\\\": 1,\\n  \\\"raw\\\": {\\n    \\\"sbg:sbgMaintained\\\": false,\\n    \\\"requirements\\\": [\\n      {\\n        \\\"class\\\": \\\"ExpressionEngineRequirement\\\",\\n        \\\"id\\\": \\\"#cwl-js-engine\\\",\\n        \\\"requirements\\\": [\\n          {\\n            \\\"class\\\": \\\"DockerRequirement\\\",\\n            \\\"dockerPull\\\": \\\"rabix/js-engine\\\"\\n          }\\n        ]\\n      }\\n    ],\\n    \\\"sbg:modifiedOn\\\": 1494849814,\\n    \\\"outputs\\\": [\\n      {\\n        \\\"label\\\": \\\"Output BAM file\\\",\\n        \\\"sbg:fileTypes\\\": \\\"BAM\\\",\\n        \\\"description\\\": \\\"Output BAM file with index (BAI or BTI) file as a secondary file (not visible in the output list of the task).\\\",\\n        \\\"id\\\": \\\"#output_bam_file\\\",\\n        \\\"type\\\": [\\n          \\\"null\\\",\\n          \\\"File\\\"\\n        ],\\n        \\\"outputBinding\\\": {\\n          \\\"glob\\\": {\\n            \\\"class\\\": \\\"Expression\\\",\\n            \\\"engine\\\": \\\"#cwl-js-engine\\\",\\n            \\\"script\\\": \\\"{\\\\n  if ($job.inputs.indexed_data === true){\\\\n\\\\treturn ''\\\\n  } else {\\\\n    return $job.inputs.input_bam_file.path.split(\\\\\\\"/\\\\\\\").pop()\\\\n  }\\\\n}\\\\n\\\\n\\\\n\\\"\\n          },\\n          \\\"secondaryFiles\\\": [\\n            \\\".bai\\\",\\n            \\\".bti\\\"\\n          ],\\n          \\\"sbg:inheritMetadataFrom\\\": \\\"#input_bam_file\\\"\\n        }\\n      },\\n      {\\n        \\\"label\\\": \\\"Generated Index File\\\",\\n        \\\"sbg:fileTypes\\\": \\\"BAI,BTI\\\",\\n        \\\"description\\\": \\\"Generated index file (without the indexed data).\\\",\\n        \\\"id\\\": \\\"#generated_index\\\",\\n        \\\"type\\\": [\\n          \\\"null\\\",\\n          \\\"File\\\"\\n        ],\\n        \\\"outputBinding\\\": {\\n          \\\"glob\\\": \\\"{*.bai,*.bti}\\\",\\n          \\\"sbg:inheritMetadataFrom\\\": \\\"#input_bam_file\\\"\\n        }\\n      }\\n    ],\\n    \\\"sbg:toolAuthor\\\": \\\"Derek Barnett, Erik Garrison, Gabor Marth, and Michael Stromberg\\\",\\n    \\\"sbg:revisionsInfo\\\": [\\n      {\\n        \\\"sbg:modifiedOn\\\": 1494849680,\\n        \\\"sbg:modifiedBy\\\": \\\"rfranklin\\\",\\n        \\\"sbg:revision\\\": 0,\\n        \\\"sbg:revisionNotes\\\": \\\"Copy of rfranklin/bam-test/bamtools-index-2-4-0/0\\\"\\n      },\\n      {\\n        \\\"sbg:modifiedOn\\\": 1494849814,\\n        \\\"sbg:modifiedBy\\\": \\\"rfranklin\\\",\\n        \\\"sbg:revision\\\": 1,\\n        \\\"sbg:revisionNotes\\\": \\\"Modified output description.\\\"\\n      }\\n    ],\\n    \\\"sbg:categories\\\": [\\n      \\\"SAM/BAM-Processing\\\",\\n      \\\"Indexing\\\"\\n    ],\\n    \\\"sbg:modifiedBy\\\": \\\"rfranklin\\\",\\n    \\\"sbg:image_url\\\": null,\\n    \\\"sbg:appVersion\\\": [\\n      \\\"sbg:draft-2\\\"\\n    ],\\n    \\\"sbg:createdBy\\\": \\\"rfranklin\\\",\\n    \\\"sbg:copyOf\\\": \\\"rfranklin/bam-test/bamtools-index-2-4-0/1\\\",\\n    \\\"stdout\\\": \\\"\\\",\\n    \\\"sbg:latestRevision\\\": 1,\\n    \\\"temporaryFailCodes\\\": [],\\n    \\\"sbg:job\\\": {\\n      \\\"inputs\\\": {\\n        \\\"bti_format\\\": false,\\n        \\\"input_bam_file\\\": {\\n          \\\"class\\\": \\\"File\\\",\\n          \\\"size\\\": 0,\\n          \\\"secondaryFiles\\\": [],\\n          \\\"path\\\": \\\"input/input_bam.bam\\\"\\n        },\\n        \\\"indexed_data\\\": false\\n      },\\n      \\\"allocatedResources\\\": {\\n        \\\"cpu\\\": 1,\\n        \\\"mem\\\": 1000\\n      }\\n    },\\n    \\\"successCodes\\\": [],\\n    \\\"sbg:links\\\": [\\n      {\\n        \\\"label\\\": \\\"Homepage\\\",\\n        \\\"id\\\": \\\"https://github.com/pezmaster31/bamtools\\\"\\n      },\\n      {\\n        \\\"label\\\": \\\"Wiki\\\",\\n        \\\"id\\\": \\\"https://github.com/pezmaster31/bamtools/wiki\\\"\\n      }\\n    ],\\n    \\\"sbg:revisionNotes\\\": \\\"Modified output description.\\\",\\n    \\\"label\\\": \\\"BamTools Index\\\",\\n    \\\"cwlVersion\\\": \\\"sbg:draft-2\\\",\\n    \\\"sbg:homepage\\\": \\\"https://github.com/pezmaster31/bamtools/wiki\\\",\\n    \\\"sbg:cmdPreview\\\": \\\"/opt/bamtools/bin/bamtools index  -in input_bam.bam\\\",\\n    \\\"stdin\\\": \\\"\\\",\\n    \\\"sbg:id\\\": \\\"rfranklin/test-project/bamtools-index-2-4-0/1\\\",\\n    \\\"hints\\\": [\\n      {\\n        \\\"class\\\": \\\"DockerRequirement\\\",\\n        \\\"dockerPull\\\": \\\"images.sbgenomics.com/markop/bamtools:2.4.0\\\",\\n        \\\"dockerImageId\\\": \\\"f808163d4cd3\\\"\\n      },\\n      {\\n        \\\"class\\\": \\\"sbg:CPURequirement\\\",\\n        \\\"value\\\": 1\\n      },\\n      {\\n        \\\"class\\\": \\\"sbg:MemRequirement\\\",\\n        \\\"value\\\": 1000\\n      }\\n    ],\\n    \\\"sbg:toolkitVersion\\\": \\\"2.4.0\\\",\\n    \\\"sbg:license\\\": \\\"The MIT License\\\",\\n    \\\"sbg:toolkit\\\": \\\"BamTools\\\",\\n    \\\"sbg:validationErrors\\\": [],\\n    \\\"class\\\": \\\"CommandLineTool\\\",\\n    \\\"inputs\\\": [\\n      {\\n        \\\"sbg:category\\\": \\\"Input & Output\\\",\\n        \\\"label\\\": \\\"Input BAM file\\\",\\n        \\\"sbg:fileTypes\\\": \\\"BAM\\\",\\n        \\\"id\\\": \\\"#input_bam_file\\\",\\n        \\\"description\\\": \\\"The input BAM file.\\\",\\n        \\\"type\\\": [\\n          \\\"File\\\"\\n        ],\\n        \\\"sbg:stageInput\\\": \\\"link\\\"\\n      },\\n      {\\n        \\\"sbg:category\\\": \\\"Input & Output\\\",\\n        \\\"description\\\": \\\"Create (non-standard) BamTools index file (*.BTI). Default behavior is to create standard BAM index (*.BAI).\\\",\\n        \\\"type\\\": [\\n          \\\"null\\\",\\n          \\\"boolean\\\"\\n        ],\\n        \\\"label\\\": \\\"BTI format\\\",\\n        \\\"id\\\": \\\"#bti_format\\\"\\n      },\\n      {\\n        \\\"sbg:category\\\": \\\"File input\\\",\\n        \\\"label\\\": \\\"Input BAI(BAM index) file\\\",\\n        \\\"sbg:fileTypes\\\": \\\"BAI\\\",\\n        \\\"id\\\": \\\"#input_bai_file\\\",\\n        \\\"description\\\": \\\"Input BAI(BAM index) file.\\\",\\n        \\\"type\\\": [\\n          \\\"null\\\",\\n          \\\"File\\\"\\n        ],\\n        \\\"sbg:stageInput\\\": \\\"link\\\"\\n      },\\n      {\\n        \\\"sbg:category\\\": \\\"Input & Output\\\",\\n        \\\"description\\\": \\\"Don't output indexed data file. The default value is [FALSE].\\\",\\n        \\\"type\\\": [\\n          \\\"null\\\",\\n          \\\"boolean\\\"\\n        ],\\n        \\\"label\\\": \\\"Don't output indexed data file\\\",\\n        \\\"id\\\": \\\"#indexed_data\\\"\\n      }\\n    ],\\n    \\\"sbg:createdOn\\\": 1494849680,\\n    \\\"arguments\\\": [\\n      {\\n        \\\"valueFrom\\\": {\\n          \\\"class\\\": \\\"Expression\\\",\\n          \\\"engine\\\": \\\"#cwl-js-engine\\\",\\n          \\\"script\\\": \\\"{\\\\n  if (!(typeof $job.inputs.input_bai_file !== \\\\\\\"undefined\\\\\\\")){\\\\n    return \\\\\\\"-in \\\\\\\" + $job.inputs.input_bam_file.path.split('/').pop() \\\\n  }\\\\n}\\\"\\n        },\\n        \\\"position\\\": 0,\\n        \\\"separate\\\": true\\n      },\\n      {\\n        \\\"valueFrom\\\": {\\n          \\\"class\\\": \\\"Expression\\\",\\n          \\\"engine\\\": \\\"#cwl-js-engine\\\",\\n          \\\"script\\\": \\\"{\\\\n  if (!(typeof $job.inputs.input_bai_file !== \\\\\\\"undefined\\\\\\\"))\\\\n    if ((typeof $job.inputs.bti_format !== \\\\\\\"undefined\\\\\\\") && ($job.inputs.bti_format))\\\\n    \\\\treturn \\\\\\\"-bti\\\\\\\"  \\\\n}\\\"\\n        },\\n        \\\"position\\\": 1,\\n        \\\"separate\\\": true\\n      }\\n    ],\\n    \\\"description\\\": \\\"BamTools Index creates an index file (BAI or BTI) for a BAM file. If BAI file is present on the input the tool will skip indexing step and output BAM with provided BAI file.\\\\n\\\\n**Common issues:** Providing a BAI file on input will result in a pass-through without execution, even if a different index format is requested on the output (BTI instead of BAI).\\\",\\n    \\\"sbg:contributors\\\": [\\n      \\\"rfranklin\\\"\\n    ],\\n    \\\"id\\\": \\\"https://cgc-api.sbgenomics.com/v2/apps/rfranklin/test-project/bamtools-index-2-4-0/1/raw/\\\",\\n    \\\"baseCommand\\\": [\\n      {\\n        \\\"class\\\": \\\"Expression\\\",\\n        \\\"engine\\\": \\\"#cwl-js-engine\\\",\\n        \\\"script\\\": \\\"{\\\\n  if ($job.inputs.input_bai_file){\\\\n \\\\treturn\\\\\\\"echo Skipping index step because BAI file is provided on the input.\\\\\\\"\\\\n  }\\\\n  else{\\\\n    return \\\\\\\"/opt/bamtools/bin/bamtools index\\\\\\\"\\\\n  }\\\\n}\\\"\\n      }\\n    ],\\n    \\\"sbg:projectName\\\": \\\"Test Project\\\",\\n    \\\"sbg:project\\\": \\\"rfranklin/test-project\\\",\\n    \\\"sbg:revision\\\": 1\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": null\n    }\n  ]\n}\n[/block]","excerpt":"/apps/{app_id}/actions/sync","slug":"synchronize-a-copied-app-with-its-parent-app","type":"endpoint","title":"Synchronize a copied app with its parent app"}

postSynchronize a copied app with its parent app

/apps/{app_id}/actions/sync

This call synchronizes a copied app with the source app from which it has been copied. For example, when **FASTQC** is copied from public apps to a project and updates are made to **FASTQC** in the public apps gallery (there are new revisions), this action fetches all revisions and revision notes from the updated parent app and applies them to your copied app. Once this has been done, the copied app is updated to the latest revision and includes the complete revision history of its parent app, following the logic of the `git pull` command. [block:code] { "codes": [ { "code": "https://cgc-api.sbgenomics.com/v2/apps/{app_id}/actions/sync", "language": "text", "name": "Path" } ] } [/block] [block:callout] { "type": "success", "body": "Recall from the [API Overview](http://docs.cancergenomicscloud.org/v1.0/docs/the-cgc-api#section-identifying-projects-users-apps-files-and-tasks) that the `app_id` has the form `{project_owner}/{project}/{app_short_name}/{revision_number}`.", "title": "app_ids" } [/block] ##Request ###Example request [block:code] { "codes": [ { "code": "POST v2/apps/rfranklin/test-project/bamtools-index-2-4-0/actions/sync HTTP/1.1\nHost: cgc-api.sbgenomics.com\nX-SBG-Auth-Token: 3259c50e1ac5426ea8f1273259740f74", "language": "http", "name": null }, { "code": "curl --data '{\"username\": \"rfranklin\", \"permissions\": { \"read\": true, \"write\": true, \"execute\": false}}' -s -H \"X-SBG-Auth-Token: 3259c50e1ac5426ea8f1273259740f74\" -H \"content-type: application/json\" -X POST \"https://cgc-api.sbgenomics.com/v2/apps/rfranklin/test-project/bamtools-index-2-4-0/actions/sync\"", "language": "curl", "name": "cURL" } ], "sidebar": true } [/block] ###Header Fields [block:parameters] { "data": { "h-0": "Name", "h-1": "Description", "0-0": "`X-SBG-Auth-Token`\n_required_", "0-1": "Your CGC [authentication token](doc:get-your-authentication-token).", "h-2": "" }, "cols": 2, "rows": 1 } [/block] ###Path parameters [block:parameters] { "data": { "0-0": "`app_id`", "h-0": "Name", "h-1": "Description", "0-1": "The ID of the app you want to update. It should reference the project owner, the project that your app is copied to, and the app's short name (containing no non-alphanumeric characters or spaces)." }, "cols": 2, "rows": 1 } [/block] ###Query parameters [block:parameters] { "data": { "h-0": "Name", "h-1": "Data type", "h-2": "Description", "0-0": "`fields`", "0-1": "string", "0-2": "Selector specifying a subset of fields to include in the response." }, "cols": 3, "rows": 1 } [/block] ##Response [See a list of CGC-specific response codes that may be contained in the body of the response.](doc:api-status-codes) ###Example response body [block:code] { "codes": [ { "code": "{\n \"href\": \"https://cgc-api.sbgenomics.com/v2/apps/rfranklin/test-project/bamtools-index-2-4-0/1\",\n \"id\": \"rfranklin/test-project/bamtools-index-2-4-0/1\",\n \"project\": \"rfranklin/test-project\",\n \"name\": \"BamTools Index\",\n \"revision\": 1,\n \"raw\": {\n \"sbg:sbgMaintained\": false,\n \"requirements\": [\n {\n \"class\": \"ExpressionEngineRequirement\",\n \"id\": \"#cwl-js-engine\",\n \"requirements\": [\n {\n \"class\": \"DockerRequirement\",\n \"dockerPull\": \"rabix/js-engine\"\n }\n ]\n }\n ],\n \"sbg:modifiedOn\": 1494849814,\n \"outputs\": [\n {\n \"label\": \"Output BAM file\",\n \"sbg:fileTypes\": \"BAM\",\n \"description\": \"Output BAM file with index (BAI or BTI) file as a secondary file (not visible in the output list of the task).\",\n \"id\": \"#output_bam_file\",\n \"type\": [\n \"null\",\n \"File\"\n ],\n \"outputBinding\": {\n \"glob\": {\n \"class\": \"Expression\",\n \"engine\": \"#cwl-js-engine\",\n \"script\": \"{\\n if ($job.inputs.indexed_data === true){\\n\\treturn ''\\n } else {\\n return $job.inputs.input_bam_file.path.split(\\\"/\\\").pop()\\n }\\n}\\n\\n\\n\"\n },\n \"secondaryFiles\": [\n \".bai\",\n \".bti\"\n ],\n \"sbg:inheritMetadataFrom\": \"#input_bam_file\"\n }\n },\n {\n \"label\": \"Generated Index File\",\n \"sbg:fileTypes\": \"BAI,BTI\",\n \"description\": \"Generated index file (without the indexed data).\",\n \"id\": \"#generated_index\",\n \"type\": [\n \"null\",\n \"File\"\n ],\n \"outputBinding\": {\n \"glob\": \"{*.bai,*.bti}\",\n \"sbg:inheritMetadataFrom\": \"#input_bam_file\"\n }\n }\n ],\n \"sbg:toolAuthor\": \"Derek Barnett, Erik Garrison, Gabor Marth, and Michael Stromberg\",\n \"sbg:revisionsInfo\": [\n {\n \"sbg:modifiedOn\": 1494849680,\n \"sbg:modifiedBy\": \"rfranklin\",\n \"sbg:revision\": 0,\n \"sbg:revisionNotes\": \"Copy of rfranklin/bam-test/bamtools-index-2-4-0/0\"\n },\n {\n \"sbg:modifiedOn\": 1494849814,\n \"sbg:modifiedBy\": \"rfranklin\",\n \"sbg:revision\": 1,\n \"sbg:revisionNotes\": \"Modified output description.\"\n }\n ],\n \"sbg:categories\": [\n \"SAM/BAM-Processing\",\n \"Indexing\"\n ],\n \"sbg:modifiedBy\": \"rfranklin\",\n \"sbg:image_url\": null,\n \"sbg:appVersion\": [\n \"sbg:draft-2\"\n ],\n \"sbg:createdBy\": \"rfranklin\",\n \"sbg:copyOf\": \"rfranklin/bam-test/bamtools-index-2-4-0/1\",\n \"stdout\": \"\",\n \"sbg:latestRevision\": 1,\n \"temporaryFailCodes\": [],\n \"sbg:job\": {\n \"inputs\": {\n \"bti_format\": false,\n \"input_bam_file\": {\n \"class\": \"File\",\n \"size\": 0,\n \"secondaryFiles\": [],\n \"path\": \"input/input_bam.bam\"\n },\n \"indexed_data\": false\n },\n \"allocatedResources\": {\n \"cpu\": 1,\n \"mem\": 1000\n }\n },\n \"successCodes\": [],\n \"sbg:links\": [\n {\n \"label\": \"Homepage\",\n \"id\": \"https://github.com/pezmaster31/bamtools\"\n },\n {\n \"label\": \"Wiki\",\n \"id\": \"https://github.com/pezmaster31/bamtools/wiki\"\n }\n ],\n \"sbg:revisionNotes\": \"Modified output description.\",\n \"label\": \"BamTools Index\",\n \"cwlVersion\": \"sbg:draft-2\",\n \"sbg:homepage\": \"https://github.com/pezmaster31/bamtools/wiki\",\n \"sbg:cmdPreview\": \"/opt/bamtools/bin/bamtools index -in input_bam.bam\",\n \"stdin\": \"\",\n \"sbg:id\": \"rfranklin/test-project/bamtools-index-2-4-0/1\",\n \"hints\": [\n {\n \"class\": \"DockerRequirement\",\n \"dockerPull\": \"images.sbgenomics.com/markop/bamtools:2.4.0\",\n \"dockerImageId\": \"f808163d4cd3\"\n },\n {\n \"class\": \"sbg:CPURequirement\",\n \"value\": 1\n },\n {\n \"class\": \"sbg:MemRequirement\",\n \"value\": 1000\n }\n ],\n \"sbg:toolkitVersion\": \"2.4.0\",\n \"sbg:license\": \"The MIT License\",\n \"sbg:toolkit\": \"BamTools\",\n \"sbg:validationErrors\": [],\n \"class\": \"CommandLineTool\",\n \"inputs\": [\n {\n \"sbg:category\": \"Input & Output\",\n \"label\": \"Input BAM file\",\n \"sbg:fileTypes\": \"BAM\",\n \"id\": \"#input_bam_file\",\n \"description\": \"The input BAM file.\",\n \"type\": [\n \"File\"\n ],\n \"sbg:stageInput\": \"link\"\n },\n {\n \"sbg:category\": \"Input & Output\",\n \"description\": \"Create (non-standard) BamTools index file (*.BTI). Default behavior is to create standard BAM index (*.BAI).\",\n \"type\": [\n \"null\",\n \"boolean\"\n ],\n \"label\": \"BTI format\",\n \"id\": \"#bti_format\"\n },\n {\n \"sbg:category\": \"File input\",\n \"label\": \"Input BAI(BAM index) file\",\n \"sbg:fileTypes\": \"BAI\",\n \"id\": \"#input_bai_file\",\n \"description\": \"Input BAI(BAM index) file.\",\n \"type\": [\n \"null\",\n \"File\"\n ],\n \"sbg:stageInput\": \"link\"\n },\n {\n \"sbg:category\": \"Input & Output\",\n \"description\": \"Don't output indexed data file. The default value is [FALSE].\",\n \"type\": [\n \"null\",\n \"boolean\"\n ],\n \"label\": \"Don't output indexed data file\",\n \"id\": \"#indexed_data\"\n }\n ],\n \"sbg:createdOn\": 1494849680,\n \"arguments\": [\n {\n \"valueFrom\": {\n \"class\": \"Expression\",\n \"engine\": \"#cwl-js-engine\",\n \"script\": \"{\\n if (!(typeof $job.inputs.input_bai_file !== \\\"undefined\\\")){\\n return \\\"-in \\\" + $job.inputs.input_bam_file.path.split('/').pop() \\n }\\n}\"\n },\n \"position\": 0,\n \"separate\": true\n },\n {\n \"valueFrom\": {\n \"class\": \"Expression\",\n \"engine\": \"#cwl-js-engine\",\n \"script\": \"{\\n if (!(typeof $job.inputs.input_bai_file !== \\\"undefined\\\"))\\n if ((typeof $job.inputs.bti_format !== \\\"undefined\\\") && ($job.inputs.bti_format))\\n \\treturn \\\"-bti\\\" \\n}\"\n },\n \"position\": 1,\n \"separate\": true\n }\n ],\n \"description\": \"BamTools Index creates an index file (BAI or BTI) for a BAM file. If BAI file is present on the input the tool will skip indexing step and output BAM with provided BAI file.\\n\\n**Common issues:** Providing a BAI file on input will result in a pass-through without execution, even if a different index format is requested on the output (BTI instead of BAI).\",\n \"sbg:contributors\": [\n \"rfranklin\"\n ],\n \"id\": \"https://cgc-api.sbgenomics.com/v2/apps/rfranklin/test-project/bamtools-index-2-4-0/1/raw/\",\n \"baseCommand\": [\n {\n \"class\": \"Expression\",\n \"engine\": \"#cwl-js-engine\",\n \"script\": \"{\\n if ($job.inputs.input_bai_file){\\n \\treturn\\\"echo Skipping index step because BAI file is provided on the input.\\\"\\n }\\n else{\\n return \\\"/opt/bamtools/bin/bamtools index\\\"\\n }\\n}\"\n }\n ],\n \"sbg:projectName\": \"Test Project\",\n \"sbg:project\": \"rfranklin/test-project\",\n \"sbg:revision\": 1\n }\n}", "language": "json", "name": null } ] } [/block]