---
title: "Add or update role setting"
method: POST
path: "/roles/{id}/settings"
tags: ["Roles"]
---

# Add or update role setting

`POST /roles/{id}/settings`

Adds or updates the visibility setting for a role.

## Path parameters

- `id` integer, required

## Request body

- object
  - `setting_key` 'deal_default_visibility' | 'lead_default_visibility' | 'org_default_visibility' | 'person_default_visibility' | 'product_default_visibility', required
  - `value` 1 | 3 | 5 | 7, required — Possible values for the `default_visibility` setting depending on the subscription plan:<br> <table class='role-setting'> <caption><b>Light / Growth and Professional plans</b></caption> <tr><th><b>Value</b></th><th><b>Description</b></th></tr> <tr><td>`1`</td><td>Owner & Followers</td></tr> <tr><td>`3`</td><td>Entire company</td></tr> </table> <br> <table class='role-setting'> <caption><b>Premium / Ultimate plan</b></caption> <tr><th><b>Value</b></th><th><b>Description</b></th></tr> <tr><td>`1`</td><td>Owner only</td></tr> <tr><td>`3`</td><td>Owner&#39;s visibility group</td></tr> <tr><td>`5`</td><td>Owner&#39;s visibility group and sub-groups</td></tr> <tr><td>`7`</td><td>Entire company</td></tr> </table> <br> Read more about visibility groups <a href='https://support.pipedrive.com/en/article/visibility-groups'>here</a>.

## Response `200`

List role settings

- object
  - `success` boolean — If the response is successful or not
  - `data` object — The response data
    - `id` integer — The ID of the role
    - `deal_default_visibility` 1 | 3 | 5 | 7 — The setting

---

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