Services / API / Methods / rtm.tasks.complete

Description

Marks a task complete.

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.

Example Response

<list id="387546">
  <taskseries id="648042" created="2006-05-07T10:19:54Z" modified="2006-05-07T10:26:21Z"
             name="Get Bananas" source="api">
    <tags/>
    <participants/>
    <notes/>
    <task id="811467" due="" has_due_time="0" added="2006-05-07T10:19:54Z"
         completed="2006-05-07T10:26:21Z" deleted="" priority="N" postponed="0" 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.