{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/assets","auth":"required","method":"post","params":[{"name":"projectId","type":"string","default":"","desc":"ID of the project","required":true,"in":"body","ref":"","_id":"54ae8b0686f2690b0072b775"},{"name":"folderId","type":"string","default":"","desc":"ID of a folder within a project.","required":false,"in":"body","ref":"","_id":"54ae93ff3697fc1600d894bb"},{"name":"title","type":"string","default":"","desc":"used as the assets display name. different from the file name.","required":false,"in":"body","ref":"","_id":"54ae8b0686f2690b0072b773"},{"name":"fileName","type":"string","default":"","desc":"name used for the asset when it is downloaded. this needs to include the file extension","required":false,"in":"body","ref":"","_id":"5c5b22572d58bd0051dc7f36"},{"name":"description","type":"string","default":"","desc":"","required":false,"in":"body","ref":"","_id":"54ae8b0686f2690b0072b772"},{"name":"sourceUrl","type":"string","default":"","desc":"Must be a publicly-accessible URL","required":true,"in":"body","ref":"","_id":"54ae8b0686f2690b0072b771"},{"name":"tags","type":"array_string","default":"","desc":"Tags","required":false,"in":"body","ref":"","_id":"54b03fe4a71047160099023c"},{"name":"versionAssetId","type":"string","default":"","desc":"ID of the asset being versioned. This asset will become the inactive version while the new asset being created will become the active version.","required":false,"in":"body","ref":"","_id":"5a1c8368acac6b001e667324"},{"name":"versionId","type":"string","default":"Timestamp of when the version was created: \"Version:13-11-2017 04:48:41.294\"","desc":"Name given to the new version.","required":false,"in":"body","ref":"","_id":"5a1c8368acac6b001e667323"}],"results":{"codes":[{"name":"","code":"{\n    \"id\": \"2af55ced-181e-4b78-a62a-dd5c5369fefb\"\n}","language":"json","status":200},{"name":"","code":"// Source file is not reachable by service\n{\n    \"sourceUrl\": \"Unable to access file at URL: http://....\"\n}","language":"json","status":400}]},"examples":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Create Asset","type":"endpoint","slug":"create-asset","excerpt":"Creates a new asset in MediaSilo","body":"Creates a new asset in MediaSilo based on an http accessible file.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"What happens on Create Asset\"\n}\n[/block]\nMediaSilo will perform a HEAD check on the sourceURL and respond with a 400 error if the file is not accessible. Once a file has been transferred by MediaSilo it is added to the encoding queue which performs the necessary file processing.","updates":[],"order":7,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"54ae8b0686f2690b0072b76f","__v":9,"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},"editedParams":true,"githubsync":"","parentDoc":null,"user":"54343147fa5527080064f43f","createdAt":"2015-01-08T13:49:58.051Z","editedParams2":true,"project":"54343170fa5527080064f449","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"}}

postCreate Asset

Creates a new asset in MediaSilo

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

projectId:
required
string
ID of the project
folderId:
string
ID of a folder within a project.
title:
string
used as the assets display name. different from the file name.
fileName:
string
name used for the asset when it is downloaded. this needs to include the file extension
description:
string
sourceUrl:
required
string
Must be a publicly-accessible URL
tags:
array of strings
Tags
versionAssetId:
string
ID of the asset being versioned. This asset will become the inactive version while the new asset being created will become the active version.
versionId:
stringTimestamp of when the version was created: "Version:13-11-2017 04:48:41.294"
Name given to the new version.

Result Format


Documentation

Creates a new asset in MediaSilo based on an http accessible file. [block:api-header] { "type": "basic", "title": "What happens on Create Asset" } [/block] MediaSilo will perform a HEAD check on the sourceURL and respond with a 400 error if the file is not accessible. Once a file has been transferred by MediaSilo it is added to the encoding queue which performs the necessary file processing.

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 }}