rtm.lists.setName
Description
Renames a list.
Availability
Available in versions 1 and 2.
Authentication
This method requires authentication with write permissions.
Timeline
This method requires a timeline.
Revertable
The effects of this method can be undone.
Arguments
api_key
(Required) 1 2- Your API application key. See here for more details.
timeline
(Required) 1 2- The timeline within which to run a method. See here for more details.
list_id
(Required) 1 2- The id of the list to perform an action on.
name
(Required) 1 2- The desired list name. Cannot be
Inbox
orSent
.
Example Response
<list id="987654321" name="New List"
deleted="0" locked="0" archived="0" position="0" smart="0"/>
Error Codes
96 Invalid signature
- The passed signature was invalid.
97 Missing signature
- The call required signing but no signature was sent.
98 Login failed / Invalid auth token
- The login details or auth token passed were invalid.
99 User not logged in / Insufficient permissions
- The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 Invalid API Key
- The API key passed was not valid or has expired.
105 Service currently unavailable
- The requested service is temporarily unavailable.
114 Invalid SOAP envelope
- The SOAP envelope sent in the request could not be parsed.
115 Invalid XML-RPC Method Call
- The XML-RPC request document could not be parsed.
120 Method not valid for requested version
- The requested method is not compatible with the requested version.
300 Timeline invalid or not provided
- No timeline provided / Timeline invalid.
320 list_id invalid or not provided
- No list_id provided / list_id invalid.
3000 List name provided is invalid.
- The list name provided is invalid.
3010 List provided is locked.
- The list provided is locked and cannot be modified.
3040 List is read-only.
- Tried to perform action in read-only list.