---
title: "Update the assignees of an action"
method: PUT
path: "/tasks/v1/actions/{task_id}/assignees"
tags: ["Actions"]
---

# Update the assignees of an action

`PUT /tasks/v1/actions/{task_id}/assignees`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/tasks/v1/actions/{task_id}/assignees`
- Auth: HTTP bearer

## Path parameters

- `task_id` string, required

## Request body

- S12TasksV1ActionsServiceUpdateAssigneesBody
  - `assignees` S12TasksV1TaskCollaborator[], required: Required. The assignees to be assigned to the task.
    - `collaborator_id` string: A UUID uniquely identifying this collaborator.
    - `collaborator_type` 'USER' | 'GROUP' | 'EXTERNAL_USER' | 'CONTRIBUTOR': - USER: The collaborator is an internal user. - GROUP: The collaborator is a group. - EXTERNAL_USER: The collaborator is an external user. This happens when a task is assigned to an email address. - CONTRIBUTOR: The collaborator is a contributor. A contributor is an individual who raises a task anonymously. For example, creating an incident through the incident QR code functionality.
    - `assigned_role` 'ASSIGNEE' | 'CREATOR': - ASSIGNEE: The collaborator has been assigned to a task. - CREATOR: The collaborator has created the task.
    - `user` S12TasksV1TaskUser: The user associated to the task. They could be a creator or assignee.
      - `user_id` string: The UUID of this user.
      - `firstname` string: The first name of the user.
      - `lastname` string: The last name of the user.
    - `group` S12TasksV1TaskGroup: The group that is assigned to a task.
      - `group_id` string: The UUID of this group.
      - `name` string: The name of the group
    - `external_user` S12TasksV1TaskExternalUser: The external user that is assigned to a task.
      - `id` string: The UUID uniquely identifying this external user.
      - `email` string: The email address of the external user.
    - `contributor` S12TasksV1TaskContributor
      - `id` string: The UUID uniquely identifying this contributor
      - `name` string: Optional. The contributor's name.
      - `email` string: Optional. The contributor's email address.
      - `contact` string: Optional. The contributor's (freetext) contact details.
  - `modified_at` string, date-time: Optional. The UTC time and date the modification took place.

## Response `200`

A successful response.

- S12TasksV1UpdateAssigneesResponse

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
