Move tasks

Move certain tasks from their current project to another project.

For security reasons, you need to perform a Login action before making any other public calls to the WorldServer API. The sessionId in the response is your session token. Use this token in all the other calls that you make.

Also, make sure that you have the appropriate user type permissions to perform this API call. To view or update your permissions, in WorldServer, go to Management > User Setup > User Types, and then select your user type.

Prerequisites

Make sure that the project to which you want to move the tasks has the same target locale as the tasks themselves.

API call

<protocol>://<ws-host>:<ws-port>/ws-api/v2/tasks/move?token=<sessionId>

Details

  • POST method
  • Content-Type in the header: application/json
  • Mandatory parameters: the session token (as a query string parameter or as a key-value pair in the header), the IDs of the tasks that you want to move (in the JSON body), and the projectId of the projects where the tasks will be moved (also in the JSON body)

Request body example

A screen shot that shows a possible JSON request body.

Response

A screen shot that shows a typical response to this call.

The response status can be:
  • OK: All the tasks have been moved.
  • PARTIAL_SUCCESS: Some of the tasks have been moved.
  • ERROR: None of the tasks has been moved.

Error messages

MessageStatus code
Task Id is not valid (The ID of the task is not a valid number.)400 Bad Request
Resource user is not valid400 Bad Request
Project Id is not valid (The ID of the project is not a valid number.)400 Bad Request
The target locale on the current task project and the destination project must be the same400 Bad Request
Project Id is null400 Bad Request
Task Id is null400 Bad Request
No session token provided or invalid token401 Unauthorized
No rights to MOVE_TASKS for resource type TASK403 Forbidden
Resource PROJECT (ID) not found404 Not Found
Resource TASK not found404 Not Found
Resource TASK (ID) not found404 Not Found