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

# Change task assignment state

export const Link = ({href, children, className, ...props}) => {
  const localizedHref = 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 update a task assignment's state call the
<Link href="/reference/put-task-assignments-id">`PUT /tasks/:task_id/assignments`</Link> API and
include a `resolution_state`, such as `completed`, `incomplete`,
`approved`, or `rejected`.

<CodeGroup>
  ```sh cURL theme={null}
  curl -i -X PUT "https://api.box.com/2.0/task_assignments/12345" \
       -H "authorization: Bearer <ACCESS_TOKEN>" \
       -H "content-type: application/json" \
       -d '{
         "message": "New message",
         "resolution_state": "completed"
       }'
  ```

  ```typescript Node/TypeScript v10 theme={null}
  await client.taskAssignments.updateTaskAssignmentById(taskAssignment.id!, {
    requestBody: {
      message: 'updated message',
      resolutionState:
        'approved' as UpdateTaskAssignmentByIdRequestBodyResolutionStateField,
    } satisfies UpdateTaskAssignmentByIdRequestBody,
  } satisfies UpdateTaskAssignmentByIdOptionalsInput);
  ```

  ```python Python v10 theme={null}
  client.task_assignments.update_task_assignment_by_id(
      task_assignment.id,
      message="updated message",
      resolution_state=UpdateTaskAssignmentByIdResolutionState.APPROVED,
  )
  ```

  ```csharp .NET v10 theme={null}
  await client.TaskAssignments.UpdateTaskAssignmentByIdAsync(taskAssignmentId: NullableUtils.Unwrap(taskAssignment.Id), requestBody: new UpdateTaskAssignmentByIdRequestBody() { Message = "updated message", ResolutionState = UpdateTaskAssignmentByIdRequestBodyResolutionStateField.Approved });
  ```

  ```swift Swift v10 theme={null}
  try await client.taskAssignments.updateTaskAssignmentById(taskAssignmentId: taskAssignment.id!, requestBody: UpdateTaskAssignmentByIdRequestBody(message: "updated message", resolutionState: UpdateTaskAssignmentByIdRequestBodyResolutionStateField.approved))
  ```

  ```java Java v10 theme={null}
  client.getTaskAssignments().updateTaskAssignmentById(taskAssignment.getId(), new UpdateTaskAssignmentByIdRequestBody.Builder().message("updated message").resolutionState(UpdateTaskAssignmentByIdRequestBodyResolutionStateField.APPROVED).build())
  ```

  ```java Java v5 theme={null}
  String assignmentID = "12345";
  BoxTaskAssignment taskAssignment = new BoxTaskAssignment(api, assignmentID);
  BoxTaskAssignment.Info info = taskAssignment.getInfo();
  info.setResolutionState(BoxTaskAssignment.ResolutionState.APPROVED);
  taskAssignment.updateInfo(info);
  ```

  ```py Python v4 theme={null}
  from boxsdk.object.task_assignment import ResolutionState
  updated_task = {'resolution_state': ResolutionState.APPROVED}
  updated_assignment = client.task_assignment(assignment_id='12345').update_info(data=updated_task)
  print(f'Assignment ID is {updated_assignment.id} and resolution state is {updated_assignment.resolution_state}')
  ```

  ```csharp .NET v6 theme={null}
  var requestParams = new BoxTaskAssignmentUpdateRequest()
  {
      Id = "12345",
      ResolutionState = ResolutionStateType.approved
  };
  BoxTaskAssignment updatedAssignment = await client.TasksManager.UpdateTaskAssignmentAsync(requestParams);
  ```

  ```js Node v4 theme={null}
  // Complete a task
  client.tasks.updateAssignment(
   '12345',
   {
    message: 'Done!',
    resolution_state: client.tasks.resolutionStates.COMPLETE
   })
   .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: 'Done!',
     completed_at: null,
     assigned_at: '2013-05-10T11:43:41-07:00',
     reminded_at: null,
     resolution_state: 'complete',
     assigned_by: 
     { type: 'user',
      id: '33333',
      name: 'Example User',
      login: 'user@example.com' } }
    */
   });
  ```
</CodeGroup>

## Resolution states

Box currently supports two types of tasks defined by the `action` value:
`review` tasks and `complete` tasks.

The type of task determines the possible resolution states a task can be in and
the interface shown to a user in the web and mobile apps.

| Task action | Possible resolution states           |
| ----------- | ------------------------------------ |
| `review`    | `incomplete`, `approved`, `rejected` |
| `complete`  | `incomplete`, `complete`             |

A `review` task starts out in an `incomplete` state and can be marked as
`incomplete`, `approved`, or `rejected`. In the user interface a user is
provided with a text box and an pair of buttons to approve or reject the task.

A `complete` task starts out in an `incomplete` state and can be marked
`incomplete` or `completed`. Once a this task is marked completed, no
further changes can be made to the task's state. In the user interface a user is
provided with a text box and an button to mark the task as completed.

<RelatedLinks
  title="RELATED APIS"
  items={[
{ label: translate("Update task assignment"), href: "/reference/put-task-assignments-id", badge: "PUT" }
]}
/>

<RelatedLinks
  title="RELATED GUIDES"
  items={[
{ label: translate("Assign a task to a user"), href: "/guides/tasks/assignments/assign", badge: "GUIDE" },
{ label: translate("Unassign a task"), href: "/guides/tasks/assignments/unassign", badge: "GUIDE" }
]}
/>