ConversationsRole

List Service Role

GET
/v1/Services/{ChatServiceSid}/Roles

Retrieve a list of all user roles in your service

Authorization

accountSid_authToken
AuthorizationBasic <token>

In: header

Path Parameters

ChatServiceSid*string

The SID of the Conversation Service to read the Role resources from.

Match^IS[0-9a-fA-F]{32}$
Length34 <= length <= 34

Query Parameters

PageSize?integer

How many resources to return in each list page. The default is 50, and the maximum is 50.

Formatint64
Range1 <= value <= 50
Page?integer

The page index. This value is simply for client state.

Range0 <= value
PageToken?string

The page token. This is provided by the API.

Response Body

application/json

curl -X GET "https://example.com/v1/Services/stringstringstringstringstringstri/Roles"

{  "meta": {    "page": 0,    "page_size": 50,    "first_page_url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Roles?PageSize=50&Page=0",    "previous_page_url": null,    "url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Roles?PageSize=50&Page=0",    "next_page_url": null,    "key": "roles"  },  "roles": [    {      "sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "chat_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "friendly_name": "Conversation Role",      "type": "conversation",      "permissions": [        "sendMessage",        "leaveConversation",        "editOwnMessage",        "deleteOwnMessage"      ],      "date_created": "2016-03-03T19:47:15Z",      "date_updated": "2016-03-03T19:47:15Z",      "url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Roles/RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"    }  ]}