Roles
Roles are a part of the Visibility groups’ feature that allow the admin user to categorize other users and dictate what items they will be allowed access to see.
Get all roles
Returns all the roles within the company.
Request
/v1/roles
Query parameters
start
integer
Pagination start
Default
0
limit
integer
Items shown per page
Response
OK
Expand all
Copy code- true
- [ ... ]▶
- { ... }▶
Get one role
Returns the details of a specific role.
Request
/v1/roles/{id}
Path parameters
id
integer
required
The ID of the role
Response
OK
Expand allCopy code- true
- { ... }▶
- { ... }▶
List role assignments
Returns all users assigned to a role.
Request
/v1/roles/{id}/assignments
Path parameters
id
integer
required
The ID of the role
Query parameters
start
integer
Pagination start
Default
0
limit
integer
Items shown per page
Response
OK
Expand allCopy code- true
- [ ... ]▶
- { ... }▶
List role settings
Returns the visibility settings of a specific role.
Request
/v1/roles/{id}/settings
Path parameters
id
integer
required
The ID of the role
Response
OK
Expand allCopy code- true
- { ... }▶
List pipeline visibility for a role
Returns the list of either visible or hidden pipeline IDs for a specific role. For more information on pipeline visibility, please refer to the Visibility groups article.
Request
/v1/roles/{id}/pipelines
Path parameters
id
integer
required
The ID of the role
Query parameters
visible
boolean
Whether to return the visible or hidden pipelines for the role
Default
true
Response
OK
Expand allCopy code- true
- { ... }▶
Add a role
Adds a new role.
Request
/v1/roles
Body parameters
application/json
name
string
required
The name of the role
parent_role_id
integer
The ID of the parent role
Response
OK
Expand allCopy code- true
- { ... }▶
Add role assignment
Assigns a user to a role.
Request
/v1/roles/{id}/assignments
Path parameters
id
integer
required
The ID of the role
Body parameters
application/json
user_id
integer
required
The ID of the user
Response
OK
Expand allCopy code- true
- { ... }▶
Add or update role setting
Adds or updates the visibility setting for a role.
Request
/v1/roles/{id}/settings
Path parameters
id
integer
required
The ID of the role
Body parameters
application/json
setting_key
string
required
Values
deal_default_visibility
lead_default_visibility
org_default_visibility
person_default_visibility
product_default_visibility
value
integer
required
Possible values for the default_visibility setting depending on the subscription plan:
| Value | Description |
|---|---|
1 | Owner & Followers |
3 | Entire company |
| Value | Description |
|---|---|
1 | Owner only |
3 | Owner's visibility group |
5 | Owner's visibility group and sub-groups |
7 | Entire company |
Read more about visibility groups here.
Values
1
3
5
7
Response
OK
Expand allCopy code- true
- { ... }▶
Update role details
Updates the parent role and/or the name of a specific role.
Request
/v1/roles/{id}
Path parameters
id
integer
required
The ID of the role
Body parameters
application/json
parent_role_id
integer
The ID of the parent role
name
string
The name of the role
Response
OK
Expand allCopy code- true
- { ... }▶
Update pipeline visibility for a role
Updates the specified pipelines to be visible and/or hidden for a specific role. For more information on pipeline visibility, please refer to the Visibility groups article.
Request
/v1/roles/{id}/pipelines
Path parameters
id
integer
required
The ID of the role
Body parameters
application/json
visible_pipeline_ids
object
required
The pipeline IDs to make the pipelines visible (add) and/or hidden (remove) for the specified role. It requires the following JSON structure: { "add": "[1]", "remove": "[3, 4]" }.
Response
OK
Expand allCopy code- true
- { ... }▶
Delete a role
Marks a role as deleted.
Request
/v1/roles/{id}
Path parameters
id
integer
required
The ID of the role
Response
OK
Expand allCopy code- true
- { ... }▶
Delete a role assignment
Removes the assigned user from a role and adds to the default role.
Request
/v1/roles/{id}/assignments
Path parameters
id
integer
required
The ID of the role
Body parameters
application/json
user_id
integer
required
The ID of the user
Response
OK
Expand allCopy code- true
- { ... }▶