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

# SalesRoles.update

`PATCH /entities/SalesRoles/{id}`

Modifies SalesRole or SalesRoles with given id(s)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `validation-level` integer

## Request body

- UpdateSalesRoleInput
  - `color_code` integer — Display color of the sales role, encoded as a 24-bit RGB integer: (red << 16) | (green << 8) | blue.
  - `name` string — Name of the entity and its default text representation.
  - `revision` integer — Revision when entity was lastly changed.

## Response `200`

Modification confirmation. Returns resulting SalesRole

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` SalesRole
    - `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.
    - `color_code` integer, required — Display color of the sales role, encoded as a 24-bit RGB integer: (red << 16) | (green << 8) | blue.
    - `name` string, required — Name of the entity and its default text representation.
    - `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/revisions/e8c12ae60aca/schema)