Update an existing user role in your account's default service
A Role resource represents a set of permissions granted to a user within a service or a conversation.
Update an existing user role in your account's default service
Path parameters
-
The SID of the Role resource to update.
Body
-
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
.
POST /v1/Roles/{Sid}
curl \
-X POST https://conversations.twilio.com/v1/Roles/{Sid} \
--user "username:password" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d 'Permission=string'
Request example
{
"Permission": [
"string"
]
}
Request examples
{
"Permission": [
"string"
]
}
Response examples (200)
{
"account_sid": "string",
"chat_service_sid": "string",
"date_created": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"friendly_name": "string",
"permissions": [
"string"
],
"sid": "string",
"type": "conversation",
"url": "https://example.com"
}
Response examples (200)
{
"account_sid": "string",
"chat_service_sid": "string",
"date_created": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"friendly_name": "string",
"permissions": [
"string"
],
"sid": "string",
"type": "conversation",
"url": "https://example.com"
}