Skip to main content
PATCH
/
roles
/
{role_id}
Update Role
curl --request PATCH \
  --url https://api.{your-broker}.slate-labs.com/roles/{role_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "display_name": "<string>",
  "description": "<string>",
  "can_export_pii": true,
  "level": 1,
  "is_active": true
}
'
{
  "id": 123,
  "name": "<string>",
  "display_name": "<string>",
  "description": "<string>",
  "customer_scope": "<string>",
  "customer_access": "<string>",
  "customer_view_scope": "<string>",
  "customer_edit_scope": "<string>",
  "pii_email": "<string>",
  "pii_phone": "<string>",
  "can_export_pii": true,
  "level": 123,
  "is_system": true,
  "is_active": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Path Parameters

role_id
integer
required

Body

application/json
display_name
string | null
Required string length: 1 - 128
description
string | null
customer_scope
enum<string> | null
Available options:
own,
team,
all
customer_access
enum<string> | null
Available options:
view,
edit
customer_view_scope
enum<string> | null
Available options:
own,
team,
all
customer_edit_scope
enum<string> | null
Available options:
none,
own,
team,
all
pii_email
enum<string> | null
Available options:
full,
masked,
hidden
pii_phone
enum<string> | null
Available options:
full,
masked,
hidden
can_export_pii
boolean | null
level
integer | null
Required range: x >= 0
is_active
boolean | null

Response

Successful Response

id
integer
required
name
string
required
display_name
string
required
description
string | null
required
customer_scope
string
required
customer_access
string
required
customer_view_scope
string
required
customer_edit_scope
string
required
pii_email
string
required
pii_phone
string
required
can_export_pii
boolean
required
level
integer
required
is_system
boolean
required
is_active
boolean
required
created_at
string<date-time>
required
updated_at
string<date-time>
required