smugmug.albums.changeSettings

Change the settings of an existing album.

Arguments

• SessionID - string.
• AlbumID - integer.

    essentials

• Title - string (optional).
• CategoryID - integer (optional).
• SubCategoryID - integer (optional).
• Description - string (optional).
• Keywords - string (optional).
• AlbumTemplateID - integer (optional).
• Geography - boolean (optional).
• HighlightID - integer (optional).
• Position - integer (optional).

   look & feel

• Header - boolean (optional, power & pro only).
• Clean - boolean (optional).
• EXIF - boolean (optional).
• Filenames - boolean (optional).
• SquareThumbs - boolean (optional).
• TemplateID - integer (optional).
  • 0: Viewer Choice
  • 3: SmugMug
  • 4: Traditional
  • 7: All Thumbs
  • 8: Slideshow
  • 9: Journal
  • 10: SmugMug Small
  • 11: Filmstrip
• SortMethod - string (optional).
  • Position
  • Caption
  • FileName
  • Date
  • DateTime
  • DateTimeOriginal
• SortDirection - boolean (optional).
  • 0: Ascending (1-99, A-Z, 1980-2004, etc)
  • 1: Descending (99-1, Z-A, 2004-1980, etc)

   security & privacy

• Password - string (optional).
• PasswordHint - string (optional).
• Public - boolean (optional).
• WorldSearchable - boolean (optional).
• SmugSearchable - boolean (optional).
• External - boolean (optional).
• Protected - boolean (optional, power & pro only).
• Watermarking - boolean (optional, pro only).
• WatermarkID - integer (optional, pro only).
• HideOwner - boolean (optional).
• Larges - boolean (optional, pro only).
• XLarges - boolean (optional, pro only).
• X2Larges - boolean (optional).
• X3Larges - boolean (optional).
• Originals - boolean (optional).

   social

• CanRank - boolean (optional).
• FriendEdit - boolean (optional).
• FamilyEdit - boolean (optional).
• Comments - boolean (optional).
• Share - boolean (optional).

   printing & sales

• Printable - boolean (optional).
• DefaultColor - boolean (optional, pro only).
  • 0: Auto Color
  • 1: True Color
• ProofDays - integer (optional, pro only).
• Backprinting - string (optional, pro only).

   photo sharpening

• UnsharpAmount - float (optional, power & pro only).
• UnsharpRadius - float (optional, power & pro only).
• UnsharpThreshold - float (optional, power & pro only).
• UnsharpSigma - float (optional, power & pro only).

   community

• CommunityID - integer (optional).

Result

Returns an empty successful response, if it completes without error.

Fault Codes

• 3 - "invalid session"
• 4 - "invalid user"
• 18 - "invalid API key"

Sample Request

http://api.smugmug.com/hack/json/1.2.0/?method=smugmug.albums.changeSettings
	&SessionID=<SESSION ID>
	&AlbumID=<ALBUM ID>
	&Description=<DESCRIPTION>

Sample Responses

REST

<rsp stat="ok">
  <method>smugmug.albums.changeSettings</method>
</rsp>

JSON

{
  "stat":"ok",
  "method":"smugmug.albums.changeSettings"
}

PHP

a:3:{
  s:4:"stat";s:2:"ok";
  s:6:"method";s:29:"smugmug.albums.changeSettings";
}

XML-RPC