Box Developer Documentation

Join BoxWorks 2024 to discover what's possible with content and AI!

Register now!

Task assignment

A task assignment defines which task is assigned to which user to complete.

string
11446498

The unique identifier for this task assignment

string
task_assignment

task_assignment

Value is always task_assignment

string (date-time)
2012-12-12T10:53:43-08:00

The date at which this task was assigned to the user.

The user who assigned this task.

The user that the task has been assigned to.

string (date-time)
2012-12-12T10:53:43-08:00

The date at which this task assignment was completed. This will be null if the task is not completed yet.

The file that the task has been assigned to.

string
Please review

A message that will is included with the task assignment. This is visible to the assigned user in the web and mobile UI.

string (date-time)
2012-12-12T10:53:43-08:00

The date at which the assigned user was reminded of this task assignment.

incomplete

The current state of the assignment. The available states depend on the action value of the task object.

Value is one of completed,incomplete,approved,rejected

Response Example

{
  "id": "11446498",
  "type": "task_assignment",
  "assigned_at": "2012-12-12T10:53:43-08:00",
  "assigned_by": {
    "id": "11446498",
    "type": "user",
    "login": "ceo@example.com",
    "name": "Aaron Levie"
  },
  "assigned_to": {
    "id": "11446498",
    "type": "user",
    "login": "ceo@example.com",
    "name": "Aaron Levie"
  },
  "completed_at": "2012-12-12T10:53:43-08:00",
  "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": "Please review",
  "reminded_at": "2012-12-12T10:53:43-08:00",
  "resolution_state": "incomplete"
}