github.com/twilio/twilio-go@v1.20.1/rest/api/v2010/docs/AccountsCallsRecordingsApi.md (about) 1 # AccountsCallsRecordingsApi 2 3 All URIs are relative to *https://api.twilio.com* 4 5 Method | HTTP request | Description 6 ------------- | ------------- | ------------- 7 [**CreateCallRecording**](AccountsCallsRecordingsApi.md#CreateCallRecording) | **Post** /2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings.json | 8 [**DeleteCallRecording**](AccountsCallsRecordingsApi.md#DeleteCallRecording) | **Delete** /2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings/{Sid}.json | 9 [**FetchCallRecording**](AccountsCallsRecordingsApi.md#FetchCallRecording) | **Get** /2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings/{Sid}.json | 10 [**ListCallRecording**](AccountsCallsRecordingsApi.md#ListCallRecording) | **Get** /2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings.json | 11 [**UpdateCallRecording**](AccountsCallsRecordingsApi.md#UpdateCallRecording) | **Post** /2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings/{Sid}.json | 12 13 14 15 ## CreateCallRecording 16 17 > ApiV2010CallRecording CreateCallRecording(ctx, CallSidoptional) 18 19 20 21 Create a recording for the call 22 23 ### Path Parameters 24 25 26 Name | Type | Description 27 ------------- | ------------- | ------------- 28 **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. 29 **CallSid** | **string** | The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) to associate the resource with. 30 31 ### Other Parameters 32 33 Other parameters are passed through a pointer to a CreateCallRecordingParams struct 34 35 36 Name | Type | Description 37 ------------- | ------------- | ------------- 38 **PathAccountSid** | **string** | The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that will create the resource. 39 **RecordingStatusCallbackEvent** | **[]string** | The recording status events on which we should call the `recording_status_callback` URL. Can be: `in-progress`, `completed` and `absent` and the default is `completed`. Separate multiple event values with a space. 40 **RecordingStatusCallback** | **string** | The URL we should call using the `recording_status_callback_method` on each recording event specified in `recording_status_callback_event`. For more information, see [RecordingStatusCallback parameters](https://www.twilio.com/docs/voice/api/recording#recordingstatuscallback). 41 **RecordingStatusCallbackMethod** | **string** | The HTTP method we should use to call `recording_status_callback`. Can be: `GET` or `POST` and the default is `POST`. 42 **Trim** | **string** | Whether to trim any leading and trailing silence in the recording. Can be: `trim-silence` or `do-not-trim` and the default is `do-not-trim`. `trim-silence` trims the silence from the beginning and end of the recording and `do-not-trim` does not. 43 **RecordingChannels** | **string** | The number of channels used in the recording. Can be: `mono` or `dual` and the default is `mono`. `mono` records all parties of the call into one channel. `dual` records each party of a 2-party call into separate channels. 44 **RecordingTrack** | **string** | The audio track to record for the call. Can be: `inbound`, `outbound` or `both`. The default is `both`. `inbound` records the audio that is received by Twilio. `outbound` records the audio that is generated from Twilio. `both` records the audio that is received and generated by Twilio. 45 46 ### Return type 47 48 [**ApiV2010CallRecording**](ApiV2010CallRecording.md) 49 50 ### Authorization 51 52 [accountSid_authToken](../README.md#accountSid_authToken) 53 54 ### HTTP request headers 55 56 - **Content-Type**: application/x-www-form-urlencoded 57 - **Accept**: application/json 58 59 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) 60 [[Back to Model list]](../README.md#documentation-for-models) 61 [[Back to README]](../README.md) 62 63 64 ## DeleteCallRecording 65 66 > DeleteCallRecording(ctx, CallSidSidoptional) 67 68 69 70 Delete a recording from your account 71 72 ### Path Parameters 73 74 75 Name | Type | Description 76 ------------- | ------------- | ------------- 77 **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. 78 **CallSid** | **string** | The [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the resources to delete. 79 **Sid** | **string** | The Twilio-provided string that uniquely identifies the Recording resource to delete. 80 81 ### Other Parameters 82 83 Other parameters are passed through a pointer to a DeleteCallRecordingParams struct 84 85 86 Name | Type | Description 87 ------------- | ------------- | ------------- 88 **PathAccountSid** | **string** | The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Recording resources to delete. 89 90 ### Return type 91 92 (empty response body) 93 94 ### Authorization 95 96 [accountSid_authToken](../README.md#accountSid_authToken) 97 98 ### HTTP request headers 99 100 - **Content-Type**: Not defined 101 - **Accept**: Not defined 102 103 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) 104 [[Back to Model list]](../README.md#documentation-for-models) 105 [[Back to README]](../README.md) 106 107 108 ## FetchCallRecording 109 110 > ApiV2010CallRecording FetchCallRecording(ctx, CallSidSidoptional) 111 112 113 114 Fetch an instance of a recording for a call 115 116 ### Path Parameters 117 118 119 Name | Type | Description 120 ------------- | ------------- | ------------- 121 **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. 122 **CallSid** | **string** | The [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the resource to fetch. 123 **Sid** | **string** | The Twilio-provided string that uniquely identifies the Recording resource to fetch. 124 125 ### Other Parameters 126 127 Other parameters are passed through a pointer to a FetchCallRecordingParams struct 128 129 130 Name | Type | Description 131 ------------- | ------------- | ------------- 132 **PathAccountSid** | **string** | The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Recording resource to fetch. 133 134 ### Return type 135 136 [**ApiV2010CallRecording**](ApiV2010CallRecording.md) 137 138 ### Authorization 139 140 [accountSid_authToken](../README.md#accountSid_authToken) 141 142 ### HTTP request headers 143 144 - **Content-Type**: Not defined 145 - **Accept**: application/json 146 147 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) 148 [[Back to Model list]](../README.md#documentation-for-models) 149 [[Back to README]](../README.md) 150 151 152 ## ListCallRecording 153 154 > []ApiV2010CallRecording ListCallRecording(ctx, CallSidoptional) 155 156 157 158 Retrieve a list of recordings belonging to the call used to make the request 159 160 ### Path Parameters 161 162 163 Name | Type | Description 164 ------------- | ------------- | ------------- 165 **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. 166 **CallSid** | **string** | The [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the resources to read. 167 168 ### Other Parameters 169 170 Other parameters are passed through a pointer to a ListCallRecordingParams struct 171 172 173 Name | Type | Description 174 ------------- | ------------- | ------------- 175 **PathAccountSid** | **string** | The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Recording resources to read. 176 **DateCreated** | **string** | The `date_created` value, specified as `YYYY-MM-DD`, of the resources to read. You can also specify inequality: `DateCreated<=YYYY-MM-DD` will return recordings generated at or before midnight on a given date, and `DateCreated>=YYYY-MM-DD` returns recordings generated at or after midnight on a date. 177 **DateCreatedBefore** | **string** | The `date_created` value, specified as `YYYY-MM-DD`, of the resources to read. You can also specify inequality: `DateCreated<=YYYY-MM-DD` will return recordings generated at or before midnight on a given date, and `DateCreated>=YYYY-MM-DD` returns recordings generated at or after midnight on a date. 178 **DateCreatedAfter** | **string** | The `date_created` value, specified as `YYYY-MM-DD`, of the resources to read. You can also specify inequality: `DateCreated<=YYYY-MM-DD` will return recordings generated at or before midnight on a given date, and `DateCreated>=YYYY-MM-DD` returns recordings generated at or after midnight on a date. 179 **PageSize** | **int** | How many resources to return in each list page. The default is 50, and the maximum is 1000. 180 **Limit** | **int** | Max number of records to return. 181 182 ### Return type 183 184 [**[]ApiV2010CallRecording**](ApiV2010CallRecording.md) 185 186 ### Authorization 187 188 [accountSid_authToken](../README.md#accountSid_authToken) 189 190 ### HTTP request headers 191 192 - **Content-Type**: Not defined 193 - **Accept**: application/json 194 195 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) 196 [[Back to Model list]](../README.md#documentation-for-models) 197 [[Back to README]](../README.md) 198 199 200 ## UpdateCallRecording 201 202 > ApiV2010CallRecording UpdateCallRecording(ctx, CallSidSidoptional) 203 204 205 206 Changes the status of the recording to paused, stopped, or in-progress. Note: Pass `Twilio.CURRENT` instead of recording sid to reference current active recording. 207 208 ### Path Parameters 209 210 211 Name | Type | Description 212 ------------- | ------------- | ------------- 213 **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. 214 **CallSid** | **string** | The [Call](https://www.twilio.com/docs/voice/api/call-resource) SID of the resource to update. 215 **Sid** | **string** | The Twilio-provided string that uniquely identifies the Recording resource to update. 216 217 ### Other Parameters 218 219 Other parameters are passed through a pointer to a UpdateCallRecordingParams struct 220 221 222 Name | Type | Description 223 ------------- | ------------- | ------------- 224 **PathAccountSid** | **string** | The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Recording resource to update. 225 **Status** | **string** | 226 **PauseBehavior** | **string** | Whether to record during a pause. Can be: `skip` or `silence` and the default is `silence`. `skip` does not record during the pause period, while `silence` will replace the actual audio of the call with silence during the pause period. This parameter only applies when setting `status` is set to `paused`. 227 228 ### Return type 229 230 [**ApiV2010CallRecording**](ApiV2010CallRecording.md) 231 232 ### Authorization 233 234 [accountSid_authToken](../README.md#accountSid_authToken) 235 236 ### HTTP request headers 237 238 - **Content-Type**: application/x-www-form-urlencoded 239 - **Accept**: application/json 240 241 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) 242 [[Back to Model list]](../README.md#documentation-for-models) 243 [[Back to README]](../README.md) 244