> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Task assignments resources

## Task assignment

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

<Accordion title="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)](/reference/files-resources#file-mini) | No       | The file that the task has been assigned to.                                                                                                                                     |
  | `assigned_to`      | [User (Mini)](/reference/users-resources#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)](/reference/users-resources#user-mini) | No       | The user who assigned this task.                                                                                                                                                 |

  ```json Example theme={null}
  {
    "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"
    }
  }
  ```
</Accordion>

## Task assignments

A list of task assignments.

<Accordion title="Attributes and example">
  | Property      | Type                                         | Required | Description                                   |
  | ------------- | -------------------------------------------- | -------- | --------------------------------------------- |
  | `total_count` | `integer`                                    | No       | The total number of items in this collection. |
  | `entries`     | array of [Task assignment](#task-assignment) | No       | A list of task assignments.                   |

  ```json Example theme={null}
  {
    "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"
        }
      }
    ]
  }
  ```
</Accordion>