Update role

POST /v1/Services/{ServiceSid}/Roles/{Sid}

Account sid auth token

Roles determining user or member permissions

Path parameters

ServiceSid string Required

The SID of the Service to update the resource from.

Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IS[0-9a-fA-F]{32}$.
Sid string Required

The Twilio-provided string that uniquely identifies the Role resource to update.

Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RL[0-9a-fA-F]{32}$.

application/x-www-form-urlencoded

Body

Permission array[string] 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. The values for this parameter depend on the role's type and are described in the documentation.

Responses

200 application/json

OK
Hide headers attributes Show headers attributes
- 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
Hide response attributes Show response attributes object
- sid string | null
  
  The unique string that we created to identify the Role resource.
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RL[0-9a-fA-F]{32}$.
- account_sid string | null
  
  The SID of the Account that created the Role resource.
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.
- service_sid string | null
  
  The SID of the Service the resource is associated with.
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IS[0-9a-fA-F]{32}$.
- friendly_name string | null
  
  The string that you assigned to describe the resource.
- type string
  
  The type of role. Can be: channel for Channel roles or deployment for Service roles.
  
  Values are channel or deployment.
- permissions array[string] | null
  
  An array of the permissions the role has been granted, formatted as a JSON string.
- date_created string(date-time) | null
  
  The date and time in GMT when the resource was created specified in RFC 2822 format.
- date_updated string(date-time) | null
  
  The date and time in GMT when the resource was last updated specified in RFC 2822 format.
- url string(uri) | null
  
  The absolute URL of the Role resource.

POST /v1/Services/{ServiceSid}/Roles/{Sid}

curl \
 --request POST 'https://chat.twilio.com/v1/Services/{ServiceSid}/Roles/{Sid}' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'Permission=sendMessage'

Request example

{"Permission"=>"sendMessage"}

Response examples (200)

{
  "sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "url": "https://chat.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Roles/RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "type": "channel",
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "permissions": [
    "sendMessage",
    "leaveChannel",
    "editOwnMessage",
    "deleteOwnMessage"
  ],
  "service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "date_created": "2016-03-03T19:47:15Z",
  "date_updated": "2016-03-03T19:47:15Z",
  "friendly_name": "channel user"
}