Movedigital.folders.editFolder

From MoveDigital Docs

While most of the parameters of this method call are required, it functions okay if you leave them blank. However, if they are left blank, these blank values will overwrite any previously saved values associated with the folder.

Table of contents

1 Arguments

2 Example Responses

3 Error Codes

4 Live REST Demo

[edit]

Arguments

Calls are POSTed to http://www.movedigital.com/services/rest/ should include the following arguments

method (required) - Must be set to: movedigital.folders.editFolder
userid (required) - The userid of the MoveDigital account.
sessionid (required) - The sessionid for the current session.
session (required) - The current session value for this sessionid.
folderid (required) - The id of the folder you wish to edit.
categoryid (optional) - The id of the category you wish to associate with this folder.
foldertags (optional) - The comma separated list of tags you wish to associate with this folder.
foldertitle (optional) - The title of this folder.
folderdescription (optional) - The description for this folder.
bindedits (optional) - Whether edits to this entry should affect other entries in the folder (eg. 'self' edits only this entry, 'license' edits only this entry and binds the license info to all entries in the folder, 'folder' binds all edits to all entries in the folder). If no value is given, it defaults to 'self'.
licensetype (optional) - The type of license for this torrent (eg. 'licenses_cc', 'licenses_cc_sampling', 'licenses_cplus_movedigital', 'licenses_other').
- licenses_cc
  - licenseattribution (optional) - The attribution value (eg. 'yes', 'no') if this is a Creative Commons (licenses_cc) type license.
  - licensecommercialuse (optional) - The commercial use value (eg. 'yes', 'no') if this is a Creative Commons (licenses_cc) type license.
  - licensemodifications (optional) - The modifications value (eg. 'yes', 'no', 'share-alike') if this is a Creative Commons (licenses_cc) type license.
- licenses_cc_sampling
  - licensesample (optional) - The sampling value (eg. 'Sampling 1.0', 'Sampling Plus 1.0', 'Noncommercial Sampling Plus 1.0') if this is a Creative Commons Sampling (licenses_cc_sampling) type license.
- licenses_other
  - licenseothername (optional) - Required if you are manually setting your own license (licensetype = licenses_other). This is the name of the license you are manually using.
  - licenseotherurl (optional) - Required if you are manually setting your own license (licensetype = licenses_other). This is the URL of the license you are manually using.

[edit]

Example Responses

Success

<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
	<method>movedigital.folder.editFolder</method>
	<format>rest</format>
	<messages>
		<message msg="Successfully edited folder." />
	</messages>
</rsp>

Error

<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
	<method>movedigital.folders.editFolder</method>
	<errors>
		<error code="83" msg="This folder is unable to be found." />
	</errors>
</rsp>

[edit]