API Queries - Update Folder

The update_folder function allows you to change settings or the status of an existing folder. This function requires additional parameters. Although optional parameters are not all required, at least one must be included. Failing to include required parameters or at least one optional will result in an error response.

Additional Parameters

• folder - Name of folder to update. (Required)
• active - To Stop or Activate the folder, use values. 0 or 1, respectively (Optional)

Note: Make sure to URL encode all values, especially the folder name.

Example query and response

In this example, we will be stopping the folder "Credit Cards".

Example query:

Note the URL encoding on the values.

Response:

<results> 
<result Setting="Active" Success="1" Value="0" /> 
</results>

The result for the setting update will be shown (represented by Success="1", meaning it was successful). The above response means that the folder's status is now stopped (represented by Value="0").

Error Responses:

Possible error responses for this function are:

• 412 - Folder is a required argument for this mode.
• 413 - No changes were requested.
• 420 - Folder could not be found.
• 421 - Folder name may only contain letters, digits or spaces.
• Other general errors, such as 200 - Internal Error or 300 - Username or API Key invalid.

For a complete list of error responses, see the Error Codes manual page.