{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/folders/:destinationFolderId/assets/:assetId/copy","auth":"required","method":"post","params":[{"name":"destinationFolderId","type":"string","default":"","desc":"ID of the destination folder","required":true,"in":"path","ref":"","_id":"54aeac7b86f2690b0072b7b1"},{"name":"assetId","type":"string","default":"","desc":"ID of the asset to copy","required":true,"in":"path","ref":"","_id":"54aeac7b86f2690b0072b7b0"},{"name":"includeComments","type":"boolean","default":"","desc":"True to copy all comments to the new asset","required":false,"in":"body","ref":"","_id":"54aeac7b86f2690b0072b7af"},{"name":"includeMetadata","type":"boolean","default":"","desc":"True to copy all metadata to the new asset","required":false,"in":"body","ref":"","_id":"54aeac7b86f2690b0072b7ae"},{"name":"includeTags","type":"boolean","default":"","desc":"True to copy all tags to the new asset","required":false,"in":"body","ref":"","_id":"54aeac7b86f2690b0072b7ad"}],"results":{"codes":[{"status":200,"language":"json","code":"// Returns the new asset id on success.\n{\n    \"id\": \"73bb4bb9-de6f-4dae-aefd-1f8f51f4d9f8\"\n}","name":""}]}},"next":{"description":"","pages":[]},"title":"Copy to Folder","type":"endpoint","slug":"copy-to-folder","excerpt":"Copies an asset to a destination folder","body":"Copies an asset to the specified folder. Copying an asset creates a new asset but does not count towards the account storage limits.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Permissions\",\n  \"body\": \"The current user must be able to create/upload assets to the project that contains the destination folder.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Performing a move with multiple assets\",\n  \"body\": \"To move multiple assets, use the BATCH endpoint.\"\n}\n[/block]","updates":["54c2c5abc2481c0d00b2f938"],"order":9,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"54aed028194a5f1f00a1d172","editedParams2":true,"githubsync":"","editedParams":true,"__v":1,"category":{"sync":{"isSync":false,"url":""},"pages":["5434906a5b10711400c6c45b","543492315b10711400c6c474","5480a347a3e4ea22000976c4","5480a36ea3e4ea22000976c5","5480a568e952bb1a006b31fb","54ae8b0686f2690b0072b76f","54aeac7b86f2690b0072b7ac","54aeae133697fc1600d894e3","54aed028194a5f1f00a1d172","54aed212194a5f1f00a1d176","54aedfb4194a5f1f00a1d199","54aee0eb194a5f1f00a1d19e","54aee1aa194a5f1f00a1d1a3","54bd5f54c264d50c00d9ef7e","54bd5f5aa0d4080c005f5449","54bd6b1fc264d50c00d9ef8e","559a9069155eef1700f4e68a"],"title":"Assets","slug":"assets","order":2,"from_sync":false,"reference":false,"_id":"543435b1edce040800409240","createdAt":"2014-10-07T18:49:21.998Z","project":"54343170fa5527080064f449","version":"54343531bfaa3d0800c4d4af","__v":17},"createdAt":"2015-01-08T18:44:56.835Z","project":"54343170fa5527080064f449","parentDoc":null,"user":"54343147fa5527080064f43f","version":{"version":"3.0","version_clean":"3.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["54343531bfaa3d0800c4d4b0","543435b1edce040800409240","543435b9edce040800409241","543435bcedce040800409243","543435bfedce040800409244","543435c2edce040800409245","54370cc426469424002a6dfa","54370cf026469424002a6dfd","5437129d26469424002a6e2f","543712d226469424002a6e30","5480c8fd74904f1a00053c86","54aafc6eefb39016009e4d71","54ac1d36de18cc1400226e01","54ad59369219922100751732","54b41bcf4f25cb1600518d2c","54b533a3a806f40c0050d53c","54b54bbf96fe3c0b00d38d2a","54b688a27379a90c00f53a8a","54b699efbc1a46160005edfa","54b8191691011f0b00068804","54bfb002d03bfc0d0000e814","54bfb33ed03bfc0d0000e816","55a3e94e912a6e2300882cdb","55a56c370f354f0d00fd02a8","55e85ad034516037002e9325","5638ecb62fc5520d001a4cf9","572cba2fc310640e008f63d5","596e6e42c5b53b00509791b1"],"_id":"54343531bfaa3d0800c4d4af","project":"54343170fa5527080064f449","releaseDate":"2014-10-07T18:47:13.086Z","__v":28,"createdAt":"2014-10-07T18:47:13.086Z","forked_from":"54343170fa5527080064f44c"}}

postCopy to Folder

Copies an asset to a destination folder

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

destinationFolderId:
required
string
ID of the destination folder
assetId:
required
string
ID of the asset to copy

Body Params

includeComments:
boolean
True to copy all comments to the new asset
includeMetadata:
boolean
True to copy all metadata to the new asset
includeTags:
boolean
True to copy all tags to the new asset

Result Format


Documentation

Copies an asset to the specified folder. Copying an asset creates a new asset but does not count towards the account storage limits. [block:callout] { "type": "warning", "title": "Permissions", "body": "The current user must be able to create/upload assets to the project that contains the destination folder." } [/block] [block:callout] { "type": "info", "title": "Performing a move with multiple assets", "body": "To move multiple assets, use the BATCH endpoint." } [/block]

User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}