Bienvenue !  Français Language Switcher

Description

Set tags for a task. tags should be a comma delimited list of tags. Any previous task tags will be overwritten.

Authentication

This method requires authentication with delete 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.
tags (Optional)
A comma delimited list of tags. An empty value removes any existing tags.

Example Response

<list id="387546">
  <taskseries id="648042" created="2006-05-07T10:19:54Z" modified="2006-05-07T11:15:17Z"
             name="Get Coffee" source="api">
    <rrule every="1">FREQ=DAILY;INTERVAL=1</rrule>
    <tags>
      <tag>coffee</tag>
      <tag>good</tag>
    </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="3" postponed="1" estimate="2 hrs"/>
  </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.