Join BoxWorks 2024 to discover what's possible with content and AI!
Register now!Task
A task allows for file-centric workflows within Box. Users can create tasks on files and assign them to other users for them to complete the tasks.
11446498The unique identifier for this task
tasktask
Value is always task
reviewThe type of task the task assignee will be prompted to perform.
Value is one of review,complete
all_assigneesDefines which assignees need to complete this task before the task is considered completed.
all_assigneesrequires all assignees to review or approve the the task in order for it to be considered completed.any_assigneeaccepts any one assignee to review or approve the the task in order for it to be considered completed.
Value is one of all_assignees,any_assignee
2012-12-12T10:53:43-08:00When the task object was created
The user who created the task
2012-12-12T10:53:43-08:00When the task is due
trueWhether the task has been completed
The file associated with the task
Legal reviewA message that will be included with the task
A collection of task assignment objects associated with the task
Response Example
{
"id": "11446498",
"type": "task",
"action": "review",
"completion_rule": "all_assignees",
"created_at": "2012-12-12T10:53:43-08:00",
"created_by": {
"id": "11446498",
"type": "user",
"login": "ceo@example.com",
"name": "Aaron Levie"
},
"due_at": "2012-12-12T10:53:43-08:00",
"is_completed": true,
"item": {
"id": "12345",
"type": "file",
"etag": "1",
"file_version": {
"id": "12345",
"type": "file_version",
"sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc"
},
"name": "Contract.pdf",
"sequence_id": "3",
"sha1": "85136C79CBF9FE36BB9D05D0639C70C265C18D37"
},
"message": "Legal review",
"task_assignment_collection": {
"entries": [
{
"id": "11446498",
"type": "task_assignment",
"item": {
"id": "12345",
"etag": "1",
"type": "file",
"sequence_id": "3",
"name": "Contract.pdf",
"sha1": "85136C79CBF9FE36BB9D05D0639C70C265C18D37",
"file_version": {
"id": "12345",
"type": "file_version",
"sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc"
}
},
"assigned_to": {
"id": "11446498",
"type": "user",
"name": "Aaron Levie",
"login": "ceo@example.com"
},
"message": "Please review",
"completed_at": "2012-12-12T10:53:43-08:00",
"assigned_at": "2012-12-12T10:53:43-08:00",
"reminded_at": "2012-12-12T10:53:43-08:00",
"resolution_state": "incomplete",
"assigned_by": {
"id": "11446498",
"type": "user",
"name": "Aaron Levie",
"login": "ceo@example.com"
}
}
],
"total_count": 100
}
}