# Update an existing user role in your service

**POST /v1/Services/{ChatServiceSid}/Roles/{Sid}**

Update an existing user role in your service
A Service Role resource represents a set of permissions granted to a user within a service or a conversation.

## Servers
- https://conversations.twilio.com: https://conversations.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **ChatServiceSid** (string)
  The SID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) to update the Role resource in.
- **Sid** (string)
  The SID of the Role resource to update.


### Body: application/x-www-form-urlencoded (object)

- **Permission** (array[string])
  A permission that you grant to the role. Only one permission can be granted per parameter. To assign more than one permission, repeat this parameter for each permission value. Note that the update action replaces all previously assigned permissions with those defined in the update action. To remove a permission, do not include it in the subsequent update action. The values for this parameter depend on the role's `type`.


## Responses
### 200
OK
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **sid** (string | null)
  The unique string that we created to identify the Role resource.
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Role resource.
- **chat_service_sid** (string | null)
  The SID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) the Role resource is associated with.
- **friendly_name** (string | null)
  The string that you assigned to describe the resource.
- **type** (string)
  The type of role. Can be: `conversation` for [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) roles or `service` for [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) roles.
- **permissions** (array[string] | null)
  An array of the permissions the role has been granted.
- **date_created** (string(date-time) | null)
  The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **date_updated** (string(date-time) | null)
  The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **url** (string(uri) | null)
  An absolute API resource URL for this user role.


[Powered by Bump.sh](https://bump.sh)