Manage Applications

    List task's assignments

    get
    https://api.box.com/2.0
    /tasks/:task_id/assignments

    Retrieves all of the assignments for a given task.

    Request

    application/json

    Path Parameters

    stringin pathrequired
    12345

    The ID of the task.

    Response

    application/jsonTask Assignments

    Returns a collection of task assignment specifying what task on a file has been assigned to which users and by who.

    application/jsonClient Error

    Returns an error if the task assignment ID was omitted in the request.

    You can now try out some of our APIs live, right here in the documentation.
    Log In

    Request Example

    cURL
    curl -X GET https://api.box.com/2.0/tasks/12345/assignments \
         -H "Authorization: Bearer <ACCESS_TOKEN>"
    .NET
    BoxCollection<BoxTaskAssignment> assignments = await client.TasksManager
        .GetAssignmentsAsync(taskId: "11111");
    Java
    BoxTask task = new BoxTask(api, "id");
    task.getAssignments();
    Node
    client.tasks.getAssignments('11111')
    	.then(assignments => {
    		/* assignments -> {
    			total_count: 1,
    			entries: 
    			[ { type: 'task_assignment',
    				id: '22222',
    				item: 
    					{ type: 'file',
    					id: '44444',
    					sequence_id: '0',
    					etag: '0',
    					sha1: '0bbd79a105c504f99573e3799756debba4c760cd',
    					name: 'box-logo.png' },
    				assigned_to: 
    					{ type: 'user',
    					id: '33333',
    					name: 'Example User',
    					login: 'user@example.com' } } ] }
    		*/
    	});

    Response Example

    {
      "total_count": 5000,
      "limit": 1000,
      "offset": 2000,
      "order": [
        {
          "by": "type",
          "direction": "ASC"
        }
      ],
      "entries": [
        {
          "id": 11446498,
          "type": "task_assignment",
          "item": {
            "id": 12345,
            "etag": 1,
            "type": "file",
            "sequence_id": 3,
            "name": "Contract.pdf"
          },
          "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"
          }
        }
      ]
    }