TWtwilio
ConversationsV1Role

Update an existing user role in your service

Changed on

Update an existing user role in your service

post/v1/Services/{ChatServiceSid}/Roles/{Sid}

Request

  • Base URL
    https://conversations.twilio.com
  • URL
    https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Roles/{Sid}
  • Auth
    HTTP basic

Path parameters

ChatServiceSidstring required

The SID of the Conversation Service to update the Role resource in.

Sidstring required

The SID of the Role resource to update.

Request body application/x-www-form-urlencoded

Permissionstring[] required

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.

Response

OK

sidstring nullable

The unique string that we created to identify the Role resource.

account_sidstring nullable

The SID of the Account that created the Role resource.

chat_service_sidstring nullable

The SID of the Conversation Service the Role resource is associated with.

friendly_namestring nullable

The string that you assigned to describe the resource.

type'conversation' | 'service'

The type of role. Can be: conversation for Conversation roles or service for Conversation Service roles.

permissionsstring[] nullable

An array of the permissions the role has been granted.

date_createdstring date-time nullable

The date and time in GMT when the resource was created specified in ISO 8601 format.

date_updatedstring date-time nullable

The date and time in GMT when the resource was last updated specified in ISO 8601 format.

urlstring uri nullable

An absolute API resource URL for this user role.

Changes