Albums‎ > ‎

bluemelon.albums.update

updates the album name, the description, the tags or set the album cover 

Authentication:
Yes (see here for details)

Arguments:

(required) long : albumid - the id of the album
(optional) string : name - the new album name
(optional) string : description - the new album description
(optional) string : tags - the new album tags
(optional) long : coveritemid - the id of the item to be set as the album cover
(optional) long : itemsperpage - the number of items per a page for this album ( -1 = My Global Settings; 0 = all; 40; 80; 120; )
(required) string : publickey - the public key of an application
(required) string : token - the access token

Request Example:

http://www.bluemelon.com/api/rest/{api_sign}/
?method=bluemelon.albums.update&albumid=1&name=newalbum&publickey={publickey}&token={token}

Response Example:

<rsp status="ok" onrequest="bluemelon.albums.update">
<content>
<album id="1" title="newalbum" url="newalbum" date="2008-10-14 00:00:00.0 CEST"/>
</content>
</rsp>

Error Codes:

4 - "Missing parameter"
5 - "Invalid parameter"
7 - "Album not found"
11 - "Item not found"
12 - "Application not found"
14 - "Invalid accessToken"
16 - "Access token timed out.You must relogin."
17 - "Invalid call signature size"
18 - "Invalid call signature"
20 - "Missing api_sign"
28 - "Item has restricted access"
30 - "Title length must be between 1 and 50"
600 - "No write permissions"
601 - "Mismatched parameter in your request"
602 - "No read permissions"
603 - "Account recently expired or deleted"

Comments