Planfix API task.getPossibleStatusToChange: Difference between revisions
From Planfix
(→Go To) |
No edit summary |
||
Line 53: | Line 53: | ||
|status || || root element describing the status || | |status || || root element describing the status || | ||
|- | |- | ||
|status.value || enum || value || a list of possible values can be found in the [[Planfix API: | |status.value || enum || value || a list of possible values can be found in the [[Planfix API:Task statuses|task statuses]] section | ||
|- | |- | ||
|status.title || string || textual representation of the status || | |status.title || string || textual representation of the status || |
Latest revision as of 14:37, 15 March 2024
A function that lets you get a list of possible statuses for the function task.changeStatus task.changeStatus. Function call format:
<?xml version="1.0" encoding="UTF-8"?>
<request method="task.getPossibleStatusToChange">
<account></account>
<sid></sid>
<task>
<id></id>
</task>
<signature></signature>
</request>
Name | Type | Value | Notes |
---|---|---|---|
task.id | int | task identifier | |
signature | string(32) | signature |
Response:
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<statusList totalCount="x">
<status>
<title></title>
<value></value>
</status>
<status>
<title></title>
<value></value>
</status>
<!-- -->
</statusList>
</response>
Name | Type | Value | Notes |
---|---|---|---|
statusList | list of statuses | ||
statusList totalCount | int | number of elements in the list | |
status | root element describing the status | ||
status.value | enum | value | a list of possible values can be found in the task statuses section |
status.title | string | textual representation of the status |
Otherwise, an error response will be returned:
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
<code></code>
</response>