> ## 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.

# Assign a task to a user

export const Link = ({href, children, className, ...props}) => {
  const localizedHref = localizeLink(href);
  return <a href={localizedHref} className={className} {...props}>
      {children}
    </a>;
};

export const MultiRelatedLinks = ({sections = []}) => {
  if (!sections || sections.length === 0) {
    return null;
  }
  return <div className="space-y-8">
      {sections.map((section, index) => <RelatedLinks key={index} title={section.title} items={section.items} />)}
    </div>;
};

export const RelatedLinks = ({title, items = []}) => {
  const getBadgeClass = badge => {
    if (!badge) return "badge-default";
    const badgeType = badge.toLowerCase().replace(/\s+/g, "-");
    return `badge-${badge === "ガイド" ? "guide" : badgeType}`;
  };
  if (!items || items.length === 0) {
    return null;
  }
  return <div className="my-8">
      {}
      <h3 className="text-sm font-bold uppercase tracking-wider mb-4">{title}</h3>

      {}
      <div className="flex flex-col gap-3">
        {items.map((item, index) => <a key={index} href={item.href} className="py-2 px-3 rounded related_link hover:bg-[#f2f2f2] dark:hover:bg-[#111827] flex items-center gap-3 group no-underline hover:no-underline border-b-0">
            {}
            <span className={`px-2 py-1 rounded-full text-xs font-semibold uppercase tracking-wide flex-shrink-0 ${getBadgeClass(item.badge)}`}>
              {item.badge}
            </span>

            {}
            <span className="text-base">{item.label}</span>
          </a>)}
      </div>
    </div>;
};

To assign a task to a user you will need to provide the
<Link href="/reference/post-task-assignments">`POST /task_assignments`</Link> API with the `id` of the
task and the user's details. For the user an application can either use the user
`id` or the user's login email, which Box refers to as their `login`.

<CodeGroup>
  ```sh cURL theme={null}
  curl -i -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"
         }
       }'
  ```

  ```typescript Node/TypeScript v10 theme={null}
  await client.taskAssignments.createTaskAssignment({
    task: new CreateTaskAssignmentRequestBodyTaskField({
      type: 'task' as CreateTaskAssignmentRequestBodyTaskTypeField,
      id: task.id!,
    }),
    assignTo: {
      id: currentUser.id,
    } satisfies CreateTaskAssignmentRequestBodyAssignToField,
  } satisfies CreateTaskAssignmentRequestBody);
  ```

  ```python Python v10 theme={null}
  client.task_assignments.create_task_assignment(
      CreateTaskAssignmentTask(type=CreateTaskAssignmentTaskTypeField.TASK, id=task.id),
      CreateTaskAssignmentAssignTo(id=current_user.id),
  )
  ```

  ```csharp .NET v10 theme={null}
  await client.TaskAssignments.CreateTaskAssignmentAsync(requestBody: new CreateTaskAssignmentRequestBody(task: new CreateTaskAssignmentRequestBodyTaskField(type: CreateTaskAssignmentRequestBodyTaskTypeField.Task, id: NullableUtils.Unwrap(task.Id)), assignTo: new CreateTaskAssignmentRequestBodyAssignToField() { Id = currentUser.Id }));
  ```

  ```swift Swift v10 theme={null}
  try await client.taskAssignments.createTaskAssignment(requestBody: CreateTaskAssignmentRequestBody(task: CreateTaskAssignmentRequestBodyTaskField(type: CreateTaskAssignmentRequestBodyTaskTypeField.task, id: task.id!), assignTo: CreateTaskAssignmentRequestBodyAssignToField(id: currentUser.id)))
  ```

  ```java Java v10 theme={null}
  client.getTaskAssignments().createTaskAssignment(new CreateTaskAssignmentRequestBody(new CreateTaskAssignmentRequestBodyTaskField.Builder(task.getId()).type(CreateTaskAssignmentRequestBodyTaskTypeField.TASK).build(), new CreateTaskAssignmentRequestBodyAssignToField.Builder().id(currentUser.getId()).build()))
  ```

  ```java Java v5 theme={null}
  BoxUser user = new BoxUser(api, "user-id")
  BoxTask task = new BoxTask(api, "id");
  task.addAssignment(user);
  ```

  ```py Python v4 theme={null}
  user = client.user(user_id='11111')
  assignment = client.task(task_id='12345').assign(user)
  print(f'Assignment ID is {assignment.id} and is assigned to user {assignment.assigned_to.name}')
  ```

  ```csharp .NET v6 theme={null}
  // 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);
  ```

  ```js Node v4 theme={null}
  // 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' } }
    */
   });
  ```
</CodeGroup>

<Note>
  # Notifications

  When creating a task an email notification is sent to the user who the task is
  assigned to.
</Note>

<Warning>
  # Permissions

  Both the user assigning the task and the user the task is being assigned to
  needs to be a collaborator on the file.
</Warning>

<RelatedLinks
  title="RELATED APIS"
  items={[
{ label: translate("Assign task"), href: "/reference/post-task-assignments", badge: "POST" }
]}
/>

<RelatedLinks
  title="RELATED GUIDES"
  items={[
{ label: translate("Unassign a task"), href: "/guides/tasks/assignments/unassign", badge: "GUIDE" },
{ label: translate("Change task assignment state"), href: "/guides/tasks/assignments/change-state", badge: "GUIDE" }
]}
/>