Task assignment
A task assignment defines which task is assigned to which user to complete.Attributes and example
Attributes and example
| Property | Type | Required | Description |
|---|---|---|---|
id | string | No | The unique identifier for this task assignment. |
type | enum<string> | No | The value will always be task_assignment. Available options: task_assignment. |
item | File (Mini) | No | The file that the task has been assigned to. |
assigned_to | User (Mini) | No | The user that the task has been assigned to. |
message | string | No | A message that will is included with the task assignment. This is visible to the assigned user in the web and mobile UI. |
completed_at | string | No | The date at which this task assignment was completed. This will be null if the task is not completed yet. |
assigned_at | string | No | The date at which this task was assigned to the user. |
reminded_at | string | No | The date at which the assigned user was reminded of this task assignment. |
resolution_state | enum<string> | No | The current state of the assignment. The available states depend on the action value of the task object. Available options: completed, incomplete, approved, rejected. |
assigned_by | User (Mini) | No | The user who assigned this task. |
Example
{
"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"
}
}
Task assignments
A list of task assignments.Attributes and example
Attributes and example
| Property | Type | Required | Description |
|---|---|---|---|
total_count | integer | No | The total number of items in this collection. |
entries | array of Task assignment | No | A list of task assignments. |
Example
{
"total_count": 100,
"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"
}
}
]
}