paymo.tasks.update
Update task info. Only fields that are sent as arguments will be updated.
Authentication
This method requires authentication by a user matching one of the following:
- having admin privileges
- assigned to the project as manager
- assigned to the task
Note: This method requires an HTTP POST request.
Arguments
api_key (Required)- Your application key. See here for more details.
auth_token (Required)- Authentication token received upon login.
task_id (Required)- The ID of the task to edit.
name (Optional)- Name of the task.
project_id (Optional)- ID of the project the task will be part of.
tasklist_id (Optional)- ID of the task list the task will be part of. Use 0 to have the task assigned to the 'Default' task list
description (Optional)- Description of the new task
complete (Optional)- 1 if task is marked as completed, 0 otherwise.
billable (Optional)- 1 if task is billable, 0 otherwise. It is used for invoicing.
price_per_hour (Optional)- Price per hour. It is used for invoicing.
due_date (Optional)- Due date for the task.
user_id (Optional)- ID of the user the task will be assigned to.
If sent but empty, the task will be assigned to anyone if the currently authenticated user is an admin or is assigned as a manager to this project.
Example Response
This method has no specific response. It returns an empty success response if it completes without error.
Error Codes
101: Unknown API method- The requested method was not found.
102: Unknown response format- The requested response format was not found.
103: Invalid API Key- The API key passed was not valid.
104: Invalid auth token / Login failed- The login details or auth token passed were invalid.
105: Insufficient permissions- The user making the method call did not have the required permissions.
106: Service currently unavailable- The service is temporarily unavailable.
107: Too many requests for this API key- The application has reached the limit for number of API calls during a specific time period. Wait a bit and try again.
108: HTTP POST request expected- The method required that parameters are sent using an HTTP POST request.
203: Project not found- The project with given ID was not found.
204: Task not found- The task with given ID was not found.
208: Blank name- Name argument was blank.
222: Task list not found- The task list with given ID was not found.
227: A user assigned to the project expected- The user with given ID was not assigned to this project. You cannot assign the task to him.
228: Invalid due date- The due date was not a valid date value. Check date and time formats.