github.com/twilio/twilio-go@v1.20.1/rest/ip_messaging/v2/docs/ServicesRolesApi.md (about)

     1  # ServicesRolesApi
     2  
     3  All URIs are relative to *https://ip-messaging.twilio.com*
     4  
     5  Method | HTTP request | Description
     6  ------------- | ------------- | -------------
     7  [**CreateRole**](ServicesRolesApi.md#CreateRole) | **Post** /v2/Services/{ServiceSid}/Roles | 
     8  [**DeleteRole**](ServicesRolesApi.md#DeleteRole) | **Delete** /v2/Services/{ServiceSid}/Roles/{Sid} | 
     9  [**FetchRole**](ServicesRolesApi.md#FetchRole) | **Get** /v2/Services/{ServiceSid}/Roles/{Sid} | 
    10  [**ListRole**](ServicesRolesApi.md#ListRole) | **Get** /v2/Services/{ServiceSid}/Roles | 
    11  [**UpdateRole**](ServicesRolesApi.md#UpdateRole) | **Post** /v2/Services/{ServiceSid}/Roles/{Sid} | 
    12  
    13  
    14  
    15  ## CreateRole
    16  
    17  > IpMessagingV2Role CreateRole(ctx, ServiceSidoptional)
    18  
    19  
    20  
    21  
    22  
    23  ### Path Parameters
    24  
    25  
    26  Name | Type | Description
    27  ------------- | ------------- | -------------
    28  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
    29  **ServiceSid** | **string** | 
    30  
    31  ### Other Parameters
    32  
    33  Other parameters are passed through a pointer to a CreateRoleParams struct
    34  
    35  
    36  Name | Type | Description
    37  ------------- | ------------- | -------------
    38  **FriendlyName** | **string** | 
    39  **Type** | **string** | 
    40  **Permission** | **[]string** | 
    41  
    42  ### Return type
    43  
    44  [**IpMessagingV2Role**](IpMessagingV2Role.md)
    45  
    46  ### Authorization
    47  
    48  [accountSid_authToken](../README.md#accountSid_authToken)
    49  
    50  ### HTTP request headers
    51  
    52  - **Content-Type**: application/x-www-form-urlencoded
    53  - **Accept**: application/json
    54  
    55  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
    56  [[Back to Model list]](../README.md#documentation-for-models)
    57  [[Back to README]](../README.md)
    58  
    59  
    60  ## DeleteRole
    61  
    62  > DeleteRole(ctx, ServiceSidSid)
    63  
    64  
    65  
    66  
    67  
    68  ### Path Parameters
    69  
    70  
    71  Name | Type | Description
    72  ------------- | ------------- | -------------
    73  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
    74  **ServiceSid** | **string** | 
    75  **Sid** | **string** | 
    76  
    77  ### Other Parameters
    78  
    79  Other parameters are passed through a pointer to a DeleteRoleParams struct
    80  
    81  
    82  Name | Type | Description
    83  ------------- | ------------- | -------------
    84  
    85  ### Return type
    86  
    87   (empty response body)
    88  
    89  ### Authorization
    90  
    91  [accountSid_authToken](../README.md#accountSid_authToken)
    92  
    93  ### HTTP request headers
    94  
    95  - **Content-Type**: Not defined
    96  - **Accept**: Not defined
    97  
    98  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
    99  [[Back to Model list]](../README.md#documentation-for-models)
   100  [[Back to README]](../README.md)
   101  
   102  
   103  ## FetchRole
   104  
   105  > IpMessagingV2Role FetchRole(ctx, ServiceSidSid)
   106  
   107  
   108  
   109  
   110  
   111  ### Path Parameters
   112  
   113  
   114  Name | Type | Description
   115  ------------- | ------------- | -------------
   116  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
   117  **ServiceSid** | **string** | 
   118  **Sid** | **string** | 
   119  
   120  ### Other Parameters
   121  
   122  Other parameters are passed through a pointer to a FetchRoleParams struct
   123  
   124  
   125  Name | Type | Description
   126  ------------- | ------------- | -------------
   127  
   128  ### Return type
   129  
   130  [**IpMessagingV2Role**](IpMessagingV2Role.md)
   131  
   132  ### Authorization
   133  
   134  [accountSid_authToken](../README.md#accountSid_authToken)
   135  
   136  ### HTTP request headers
   137  
   138  - **Content-Type**: Not defined
   139  - **Accept**: application/json
   140  
   141  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
   142  [[Back to Model list]](../README.md#documentation-for-models)
   143  [[Back to README]](../README.md)
   144  
   145  
   146  ## ListRole
   147  
   148  > []IpMessagingV2Role ListRole(ctx, ServiceSidoptional)
   149  
   150  
   151  
   152  
   153  
   154  ### Path Parameters
   155  
   156  
   157  Name | Type | Description
   158  ------------- | ------------- | -------------
   159  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
   160  **ServiceSid** | **string** | 
   161  
   162  ### Other Parameters
   163  
   164  Other parameters are passed through a pointer to a ListRoleParams struct
   165  
   166  
   167  Name | Type | Description
   168  ------------- | ------------- | -------------
   169  **PageSize** | **int** | How many resources to return in each list page. The default is 50, and the maximum is 1000.
   170  **Limit** | **int** | Max number of records to return.
   171  
   172  ### Return type
   173  
   174  [**[]IpMessagingV2Role**](IpMessagingV2Role.md)
   175  
   176  ### Authorization
   177  
   178  [accountSid_authToken](../README.md#accountSid_authToken)
   179  
   180  ### HTTP request headers
   181  
   182  - **Content-Type**: Not defined
   183  - **Accept**: application/json
   184  
   185  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
   186  [[Back to Model list]](../README.md#documentation-for-models)
   187  [[Back to README]](../README.md)
   188  
   189  
   190  ## UpdateRole
   191  
   192  > IpMessagingV2Role UpdateRole(ctx, ServiceSidSidoptional)
   193  
   194  
   195  
   196  
   197  
   198  ### Path Parameters
   199  
   200  
   201  Name | Type | Description
   202  ------------- | ------------- | -------------
   203  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
   204  **ServiceSid** | **string** | 
   205  **Sid** | **string** | 
   206  
   207  ### Other Parameters
   208  
   209  Other parameters are passed through a pointer to a UpdateRoleParams struct
   210  
   211  
   212  Name | Type | Description
   213  ------------- | ------------- | -------------
   214  **Permission** | **[]string** | 
   215  
   216  ### Return type
   217  
   218  [**IpMessagingV2Role**](IpMessagingV2Role.md)
   219  
   220  ### Authorization
   221  
   222  [accountSid_authToken](../README.md#accountSid_authToken)
   223  
   224  ### HTTP request headers
   225  
   226  - **Content-Type**: application/x-www-form-urlencoded
   227  - **Accept**: application/json
   228  
   229  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
   230  [[Back to Model list]](../README.md#documentation-for-models)
   231  [[Back to README]](../README.md)
   232