Planfix API task.changeWorkers

From Planfix
Revision as of 10:47, 12 December 2024 by Dmitri (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

This function is used to modify a list of task assignees. Function call format:

<?xml version="1.0" encoding="UTF-8"?>
<request method="task.changeWorkers">
  <account></account>
  <sid></sid>
  <task>
    <id></id>
    <workers>
      <addUsers>
        <id></id>
        <id></id>
        <!-- ... -->
      </addUsers>
      <addGroups>
        <id></id>
        <id></id>
        <!-- ... -->
      </addGroups>
      <delUsers>
        <id></id>
        <id></id>
        <!-- ... -->
      </delUsers>
      <delGroups>
        <id></id>
        <id></id>
        <!-- ... -->
      </delGroups>
    </workers>
  </task>
  <signature></signature>
</request>
Name Type Value Notes
task.id int task ID
workers root element of the list of task assignees
workers.addUsers root element of the list of users who are connected to the task
workers.addUsers.id int identifier of the user who is being connected to the task
workers.addGroups root element of the list of groups that are connected to the task
workers.addGroups.id int group identifier
workers.delUsers root element of the list of users who are being deleted from the list of assignees
workers.delUsers.id int identifier of the user who is being deleted from the assignee list
workers.delGroups root element of the list of groups that are being deleted from the list of assignees
workers.delGroups.id int group identifier
signature string(32) signature


Response:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <task>
    <id></id>
  </task>
</response>
Name Type Value Notes
task.id int task ID


Otherwise, an error response will be returned:

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>


Go To