---
title: "TaskSharingSalesUnitRelations.update"
method: PATCH
path: "/entities/TaskSharingSalesUnitRelations/{id}"
tags: ["Activity"]
---

# TaskSharingSalesUnitRelations.update

`PATCH /entities/TaskSharingSalesUnitRelations/{id}`

Modifies TaskSharingSalesUnitRelation or TaskSharingSalesUnitRelations with given id(s)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `validation-level` integer

## Request body

- UpdateTaskSharingSalesUnitRelationInput
  - `role` 1 | 2 — Sharing role granting the unit a specific access level (e.g. Read, Edit) on the task. Integer enum value: 1 - Watcher, 2 - Editor
  - `task_id` string, uuid — Id of the shared task.
  - `unit_id` string, uuid — Id of the sales unit.
  - `revision` integer — Revision when entity was lastly changed.

## Response `200`

Modification confirmation. Returns resulting TaskSharingSalesUnitRelation

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` TaskSharingSalesUnitRelation
    - `is_delete_protected` boolean, required — Tells if the entity instance is protected against delete (Entities that need to be present in the system at any time). Delete action still may fail if entity is deletable, due some other additional validations.
    - `id` string, uuid, required — Unique identifier of entity.
    - `is_deleted` boolean — Specifies if the entity is considered deleted.
    - `modified` string, date-time — Last modification time.
    - `created` string, date-time — Creation time.
    - `task` string, uri, required — Task being shared. Relation to Task. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Task' object for properties.
    - `unit` string, uri, required — Sales unit the task is shared with. Relation to SalesUnit. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'SalesUnit' object for properties.
    - `role` 1 | 2 — Sharing role granting the unit a specific access level (e.g. Read, Edit) on the task. Integer enum value: 1 - Watcher, 2 - Editor
    - `task_id` string, uuid, required — Id of the shared task.
    - `unit_id` string, uuid, required — Id of the sales unit.
    - `revision` integer — Revision when entity was lastly changed.

## Other responses

- `404` — Sent when invalid ID is given
- `500` — unexpected error

---

[API](https://skmtc.net/aws/apis/pipeliner-cloud-api.md) · [All operations](https://skmtc.net/aws/apis/pipeliner-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/pipeliner-cloud-api/versions/e8c12ae60aca/schema)