Assign task
Assigns a task to a user.
A task can be assigned to more than one user by creating multiple assignments.
Request
Request Body
The user to assign the task to.
3242343The ID of the user to assign to the task.
To specify a user by their email
address use the login parameter.
john@example.comThe email address of the user to assign to the task.
To specify a user by their user ID please use the id parameter.
The task to assign to a user.
11446498The ID of the task
taskValue is always task
Response
Returns a new task assignment object.
Returns an error if a change to a completed task is attempted
Returns an error when the task could not be found or the user does not have access to the file the task is assigned to.
Returns an error if any of the IDs for this request were not valid, or if the targeted user does not have access to the file.
An unexpected client error.
Request Example
curl -X POST https://api.box.com/2.0/task_assignments \
-H 'Authorization: Bearer <ACCESS_TOKEN>'
-H 'Content-Type: application/json" '
-d '{
"task": {
"id": "11446498",
"type": "task"
},
"assign_to": {
"id": "4823213"
}
}'// Assign task 11111 to user 22222
var assignmentParams = new BoxTaskAssignmentRequest()
{
Task = new BoxTaskRequest()
{
Id = "11111"
},
AssignTo = new BoxAssignmentRequest()
{
Id = "22222"
}
};
BoxTaskAssignment assignment = await client.TasksManager.CreateTaskAssignmentAsync(assignmentParams);BoxUser user = new BoxUser(api, "user-id")
BoxTask task = new BoxTask(api, "id");
task.addAssignment(user);user = client.user(user_id='11111')
assignment = client.task(task_id='12345').assign(user)
print('Assignment ID is {0} and is assigned to user {1}'.format(assignment.id, assignment.assigned_to.name))// Assign task 11111 to user 22222
var taskID = '11111';
var userID = '22222';
client.tasks.assignByUserID(taskID, userID)
.then(assignment => {
/* assignment -> {
type: 'task_assignment',
id: '12345',
item:
{ type: 'file',
id: '33333',
sequence_id: '0',
etag: '0',
sha1: '7840095ee096ee8297676a138d4e316eabb3ec96',
name: 'script.js' },
assigned_to:
{ type: 'user',
id: '22222',
name: 'Sample Assignee',
login: 'assignee@exmaple.com' },
message: null,
completed_at: null,
assigned_at: '2013-05-10T11:43:41-07:00',
reminded_at: null,
resolution_state: 'incomplete',
assigned_by:
{ type: 'user',
id: '33333',
name: 'Example User',
login: 'user@example.com' } }
*/
});