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.
string
11446498The unique identifier for this task
string
tasktask
Value is always task
string
reviewThe type of task the task assignee will be prompted to perform.
Value is one of review,complete
string
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
string (date-time)
2012-12-12T10:53:43-08:00When the task object was created
User (Mini) object
The user who created the task
string (date-time)
2012-12-12T10:53:43-08:00When the task is due
boolean
trueWhether the task has been completed
File (Mini) object
The file associated with the task
string
Legal reviewA message that will be included with the task
Task assignments object
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
}
}