Bonvenon!  Esperanto Language Switcher

Description

Sets the priority of a task. Valid values are 1, 2 and 3. If priority is not specified or is an invalid value, the task is marked as having no priority.

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)
Your API application key. See here for more details.
timeline (Required)
The timeline within which to run a method. See here for more details.
list_id (Required)
The id of the list to perform an action on.
taskseries_id (Required)
The id of the task series to perform an action on.
task_id (Required)
The id of the task to perform an action on.
priority (Optional)
The desired priority of a task. Valid values are 1, 2 and 3. If priority is not specified or is an invalid value, the task is marked as having no priority.

Example Response

<list id="387546">
  <taskseries id="648042" created="2006-05-07T10:19:54Z" modified="2006-05-07T10:48:03Z"
             name="Get Coffee" source="api">
    <tags/>
    <participants/>
    <notes/>
    <task id="811467" due="2006-05-09T14:00:00Z" has_due_time="0" added="2006-05-07T10:19:54Z"
         completed="" deleted="" priority="2" postponed="1" estimate=""/>
  </taskseries>
</list>

Error Codes

98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
100: Invalid API Key
The API key passed was not valid or has expired.
105: Service currently unavailable
The requested service is temporarily unavailable.
111: Format "xxx" not found
The requested response format was not found.
112: Method "xxx" not found
The requested method was not found.
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.
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.