Change task assignment state
Change task assignment state
To update a task assignment's state call the
PUT /tasks/:task_id/assignments
API and
include a resolution_state
, such as completed
, incomplete
,
approved
, or rejected
.
curl -i -X PUT "https://api.box.com/2.0/task_assignments/12345" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-H "content-type: application/json" \
-d '{
"message": "New message",
"resolution_state": "completed"
}'
Resolution states
Box currently supports two types of tasks defined by the action
value:
review
tasks and complete
tasks.
The type of task determines the possible resolution states a task can be in and the interface shown to a user in the web and mobile apps.
Task action | Possible resolution states |
---|---|
review | incomplete , approved , rejected |
complete | incomplete , complete |
A review
task starts out in an incomplete
state and can be marked as
incomplete
, approved
, or rejected
. In the user interface a user is
provided with a text box and an pair of buttons to approve or reject the task.
A complete
task starts out in an incomplete
state and can be marked
incomplete
or completed
. Once a this task is marked completed, no
further changes can be made to the task's state. In the user interface a user is
provided with a text box and an button to mark the task as completed.