# system.kanoa.dashboard.updateFolder(folderInfo, userId)

Updates a folder

---
### Parameters
**folderInfo** `Dictionary`<br />
<table class='dictionaryKeyTable'>
	<tbody>
 	<tr><td> - folderDescription</td><td>String</td><td></td></tr>	
 	<tr><td> - folderId</td><td>Integer</td><td>The id of the folder being updated</td></tr>	
 	<tr><td> - folderName</td><td>String</td><td>The name of the folder. This must be unique within the folder.</td></tr>	
 	<tr><td> - icon</td><td>String</td><td>The path to the icon for this folder.</td></tr>	
 	<tr><td> - iconColor</td><td>String</td><td>The color of the icon for this folder.</td></tr>	
 	<tr><td> - parentId</td><td>Integer</td><td>The id of the parent this folder is going into. Use None if the folder is going onto the root.</td></tr>	
 	<tr><td> - roles</td><td>[string]</td><td>An array of roles that are able to view this folder.</td></tr>	
 	<tr><td> - sortOrder</td><td>Integer</td><td>Determines where within the folder the folder in placed relative to other folders. If the same as another folder, then sorted by name.</td></tr>	
	</tbody>
</table>

**userId** `Integer`: Id of user executing the function<br />

---
### Returns
**# of records modified** `Integer`<br />
**message** `String` None if successful<br />

---
### Example
```python
folderInfo = {
  "folderId": 12,
  "folderName": "Jason's Dashboards",
  "folderDescription": "All my personal dashboards in one place",
  "icon": None,
  "iconColor": None,
  "parentId": None,
  "roles": None,
  "sortOrder": None
}
userId = 123
retVal, msg = system.kanoa.dashboard.updateFolder(folderInfo, userId)
if msg:	system.perspective.sendMessage('showFailerToast', msg)
else: system.perspective.sendMessage('showSuccessfulToast', 'Folder has been updated')
>
```