github.com/twilio/twilio-go@v1.20.1/rest/events/v1/docs/SinksApi.md (about)

     1  # SinksApi
     2  
     3  All URIs are relative to *https://events.twilio.com*
     4  
     5  Method | HTTP request | Description
     6  ------------- | ------------- | -------------
     7  [**CreateSink**](SinksApi.md#CreateSink) | **Post** /v1/Sinks | 
     8  [**DeleteSink**](SinksApi.md#DeleteSink) | **Delete** /v1/Sinks/{Sid} | 
     9  [**FetchSink**](SinksApi.md#FetchSink) | **Get** /v1/Sinks/{Sid} | 
    10  [**ListSink**](SinksApi.md#ListSink) | **Get** /v1/Sinks | 
    11  [**UpdateSink**](SinksApi.md#UpdateSink) | **Post** /v1/Sinks/{Sid} | 
    12  
    13  
    14  
    15  ## CreateSink
    16  
    17  > EventsV1Sink CreateSink(ctx, optional)
    18  
    19  
    20  
    21  Create a new Sink
    22  
    23  ### Path Parameters
    24  
    25  This endpoint does not need any path parameter.
    26  
    27  ### Other Parameters
    28  
    29  Other parameters are passed through a pointer to a CreateSinkParams struct
    30  
    31  
    32  Name | Type | Description
    33  ------------- | ------------- | -------------
    34  **Description** | **string** | A human readable description for the Sink **This value should not contain PII.**
    35  **SinkConfiguration** | [**interface{}**](interface{}.md) | The information required for Twilio to connect to the provided Sink encoded as JSON.
    36  **SinkType** | **string** | 
    37  
    38  ### Return type
    39  
    40  [**EventsV1Sink**](EventsV1Sink.md)
    41  
    42  ### Authorization
    43  
    44  [accountSid_authToken](../README.md#accountSid_authToken)
    45  
    46  ### HTTP request headers
    47  
    48  - **Content-Type**: application/x-www-form-urlencoded
    49  - **Accept**: application/json
    50  
    51  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
    52  [[Back to Model list]](../README.md#documentation-for-models)
    53  [[Back to README]](../README.md)
    54  
    55  
    56  ## DeleteSink
    57  
    58  > DeleteSink(ctx, Sid)
    59  
    60  
    61  
    62  Delete a specific Sink.
    63  
    64  ### Path Parameters
    65  
    66  
    67  Name | Type | Description
    68  ------------- | ------------- | -------------
    69  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
    70  **Sid** | **string** | A 34 character string that uniquely identifies this Sink.
    71  
    72  ### Other Parameters
    73  
    74  Other parameters are passed through a pointer to a DeleteSinkParams struct
    75  
    76  
    77  Name | Type | Description
    78  ------------- | ------------- | -------------
    79  
    80  ### Return type
    81  
    82   (empty response body)
    83  
    84  ### Authorization
    85  
    86  [accountSid_authToken](../README.md#accountSid_authToken)
    87  
    88  ### HTTP request headers
    89  
    90  - **Content-Type**: Not defined
    91  - **Accept**: Not defined
    92  
    93  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
    94  [[Back to Model list]](../README.md#documentation-for-models)
    95  [[Back to README]](../README.md)
    96  
    97  
    98  ## FetchSink
    99  
   100  > EventsV1Sink FetchSink(ctx, Sid)
   101  
   102  
   103  
   104  Fetch a specific Sink.
   105  
   106  ### Path Parameters
   107  
   108  
   109  Name | Type | Description
   110  ------------- | ------------- | -------------
   111  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
   112  **Sid** | **string** | A 34 character string that uniquely identifies this Sink.
   113  
   114  ### Other Parameters
   115  
   116  Other parameters are passed through a pointer to a FetchSinkParams struct
   117  
   118  
   119  Name | Type | Description
   120  ------------- | ------------- | -------------
   121  
   122  ### Return type
   123  
   124  [**EventsV1Sink**](EventsV1Sink.md)
   125  
   126  ### Authorization
   127  
   128  [accountSid_authToken](../README.md#accountSid_authToken)
   129  
   130  ### HTTP request headers
   131  
   132  - **Content-Type**: Not defined
   133  - **Accept**: application/json
   134  
   135  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
   136  [[Back to Model list]](../README.md#documentation-for-models)
   137  [[Back to README]](../README.md)
   138  
   139  
   140  ## ListSink
   141  
   142  > []EventsV1Sink ListSink(ctx, optional)
   143  
   144  
   145  
   146  Retrieve a paginated list of Sinks belonging to the account used to make the request.
   147  
   148  ### Path Parameters
   149  
   150  This endpoint does not need any path parameter.
   151  
   152  ### Other Parameters
   153  
   154  Other parameters are passed through a pointer to a ListSinkParams struct
   155  
   156  
   157  Name | Type | Description
   158  ------------- | ------------- | -------------
   159  **InUse** | **bool** | A boolean query parameter filtering the results to return sinks used/not used by a subscription.
   160  **Status** | **string** | A String query parameter filtering the results by status `initialized`, `validating`, `active` or `failed`.
   161  **PageSize** | **int** | How many resources to return in each list page. The default is 50, and the maximum is 1000.
   162  **Limit** | **int** | Max number of records to return.
   163  
   164  ### Return type
   165  
   166  [**[]EventsV1Sink**](EventsV1Sink.md)
   167  
   168  ### Authorization
   169  
   170  [accountSid_authToken](../README.md#accountSid_authToken)
   171  
   172  ### HTTP request headers
   173  
   174  - **Content-Type**: Not defined
   175  - **Accept**: application/json
   176  
   177  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
   178  [[Back to Model list]](../README.md#documentation-for-models)
   179  [[Back to README]](../README.md)
   180  
   181  
   182  ## UpdateSink
   183  
   184  > EventsV1Sink UpdateSink(ctx, Sidoptional)
   185  
   186  
   187  
   188  Update a specific Sink
   189  
   190  ### Path Parameters
   191  
   192  
   193  Name | Type | Description
   194  ------------- | ------------- | -------------
   195  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
   196  **Sid** | **string** | A 34 character string that uniquely identifies this Sink.
   197  
   198  ### Other Parameters
   199  
   200  Other parameters are passed through a pointer to a UpdateSinkParams struct
   201  
   202  
   203  Name | Type | Description
   204  ------------- | ------------- | -------------
   205  **Description** | **string** | A human readable description for the Sink **This value should not contain PII.**
   206  
   207  ### Return type
   208  
   209  [**EventsV1Sink**](EventsV1Sink.md)
   210  
   211  ### Authorization
   212  
   213  [accountSid_authToken](../README.md#accountSid_authToken)
   214  
   215  ### HTTP request headers
   216  
   217  - **Content-Type**: application/x-www-form-urlencoded
   218  - **Accept**: application/json
   219  
   220  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
   221  [[Back to Model list]](../README.md#documentation-for-models)
   222  [[Back to README]](../README.md)
   223