Sets the priority of a task. Valid values are
priority is not specified or is an invalid value, the task is marked as having no priority.
Available in versions 1 and 2.
This method requires authentication with write permissions.
This method requires a timeline.
The effects of this method can be undone.
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.
taskseries_id(Required) 1 2
- The id of the task series to perform an action on.
task_id(Required) 1 2
- The id of the task to perform an action on.
- The desired priority of a task. Valid values are
3. If priority is not specified or is an invalid value, the task is marked as having no priority.
<list id="387546"> <taskseries id="648042" created="2015-05-07T10:19:54Z" modified="2015-05-07T10:48:03Z" name="Get Coffee" source="api"> <tags/> <participants/> <notes/> <task id="811467" due="2015-05-09T14:00:00Z" has_due_time="0" added="2015-05-07T10:19:54Z" completed="" deleted="" priority="2" postponed="1" estimate=""/> </taskseries> </list>
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.
340 taskseries_id/task_id invalid or not provided
- No taskseries_id or task_id provided / taskseries_id or task_id invalid.
3040 List is read-only.
- Tried to perform action in read-only list.
4040 Sub-task only editable by Pro accounts
- Non-pro account tried to update sub-task.