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

     1  # WorkspacesTasksReservationsApi
     2  
     3  All URIs are relative to *https://taskrouter.twilio.com*
     4  
     5  Method | HTTP request | Description
     6  ------------- | ------------- | -------------
     7  [**FetchTaskReservation**](WorkspacesTasksReservationsApi.md#FetchTaskReservation) | **Get** /v1/Workspaces/{WorkspaceSid}/Tasks/{TaskSid}/Reservations/{Sid} | 
     8  [**ListTaskReservation**](WorkspacesTasksReservationsApi.md#ListTaskReservation) | **Get** /v1/Workspaces/{WorkspaceSid}/Tasks/{TaskSid}/Reservations | 
     9  [**UpdateTaskReservation**](WorkspacesTasksReservationsApi.md#UpdateTaskReservation) | **Post** /v1/Workspaces/{WorkspaceSid}/Tasks/{TaskSid}/Reservations/{Sid} | 
    10  
    11  
    12  
    13  ## FetchTaskReservation
    14  
    15  > TaskrouterV1TaskReservation FetchTaskReservation(ctx, WorkspaceSidTaskSidSid)
    16  
    17  
    18  
    19  
    20  
    21  ### Path Parameters
    22  
    23  
    24  Name | Type | Description
    25  ------------- | ------------- | -------------
    26  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
    27  **WorkspaceSid** | **string** | The SID of the Workspace with the TaskReservation resource to fetch.
    28  **TaskSid** | **string** | The SID of the reserved Task resource with the TaskReservation resource to fetch.
    29  **Sid** | **string** | The SID of the TaskReservation resource to fetch.
    30  
    31  ### Other Parameters
    32  
    33  Other parameters are passed through a pointer to a FetchTaskReservationParams struct
    34  
    35  
    36  Name | Type | Description
    37  ------------- | ------------- | -------------
    38  
    39  ### Return type
    40  
    41  [**TaskrouterV1TaskReservation**](TaskrouterV1TaskReservation.md)
    42  
    43  ### Authorization
    44  
    45  [accountSid_authToken](../README.md#accountSid_authToken)
    46  
    47  ### HTTP request headers
    48  
    49  - **Content-Type**: Not defined
    50  - **Accept**: application/json
    51  
    52  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
    53  [[Back to Model list]](../README.md#documentation-for-models)
    54  [[Back to README]](../README.md)
    55  
    56  
    57  ## ListTaskReservation
    58  
    59  > []TaskrouterV1TaskReservation ListTaskReservation(ctx, WorkspaceSidTaskSidoptional)
    60  
    61  
    62  
    63  
    64  
    65  ### Path Parameters
    66  
    67  
    68  Name | Type | Description
    69  ------------- | ------------- | -------------
    70  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
    71  **WorkspaceSid** | **string** | The SID of the Workspace with the TaskReservation resources to read.
    72  **TaskSid** | **string** | The SID of the reserved Task resource with the TaskReservation resources to read.
    73  
    74  ### Other Parameters
    75  
    76  Other parameters are passed through a pointer to a ListTaskReservationParams struct
    77  
    78  
    79  Name | Type | Description
    80  ------------- | ------------- | -------------
    81  **ReservationStatus** | **string** | Returns the list of reservations for a task with a specified ReservationStatus.  Can be: `pending`, `accepted`, `rejected`, or `timeout`.
    82  **WorkerSid** | **string** | The SID of the reserved Worker resource to read.
    83  **PageSize** | **int** | How many resources to return in each list page. The default is 50, and the maximum is 1000.
    84  **Limit** | **int** | Max number of records to return.
    85  
    86  ### Return type
    87  
    88  [**[]TaskrouterV1TaskReservation**](TaskrouterV1TaskReservation.md)
    89  
    90  ### Authorization
    91  
    92  [accountSid_authToken](../README.md#accountSid_authToken)
    93  
    94  ### HTTP request headers
    95  
    96  - **Content-Type**: Not defined
    97  - **Accept**: application/json
    98  
    99  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
   100  [[Back to Model list]](../README.md#documentation-for-models)
   101  [[Back to README]](../README.md)
   102  
   103  
   104  ## UpdateTaskReservation
   105  
   106  > TaskrouterV1TaskReservation UpdateTaskReservation(ctx, WorkspaceSidTaskSidSidoptional)
   107  
   108  
   109  
   110  
   111  
   112  ### Path Parameters
   113  
   114  
   115  Name | Type | Description
   116  ------------- | ------------- | -------------
   117  **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
   118  **WorkspaceSid** | **string** | The SID of the Workspace with the TaskReservation resources to update.
   119  **TaskSid** | **string** | The SID of the reserved Task resource with the TaskReservation resources to update.
   120  **Sid** | **string** | The SID of the TaskReservation resource to update.
   121  
   122  ### Other Parameters
   123  
   124  Other parameters are passed through a pointer to a UpdateTaskReservationParams struct
   125  
   126  
   127  Name | Type | Description
   128  ------------- | ------------- | -------------
   129  **IfMatch** | **string** | The If-Match HTTP request header
   130  **ReservationStatus** | **string** | 
   131  **WorkerActivitySid** | **string** | The new worker activity SID if rejecting a reservation.
   132  **Instruction** | **string** | The assignment instruction for reservation.
   133  **DequeuePostWorkActivitySid** | **string** | The SID of the Activity resource to start after executing a Dequeue instruction.
   134  **DequeueFrom** | **string** | The Caller ID of the call to the worker when executing a Dequeue instruction.
   135  **DequeueRecord** | **string** | Whether to record both legs of a call when executing a Dequeue instruction or which leg to record.
   136  **DequeueTimeout** | **int** | Timeout for call when executing a Dequeue instruction.
   137  **DequeueTo** | **string** | The Contact URI of the worker when executing a Dequeue instruction. Can be the URI of the Twilio Client, the SIP URI for Programmable SIP, or the [E.164](https://www.twilio.com/docs/glossary/what-e164) formatted phone number, depending on the destination.
   138  **DequeueStatusCallbackUrl** | **string** | The Callback URL for completed call event when executing a Dequeue instruction.
   139  **CallFrom** | **string** | The Caller ID of the outbound call when executing a Call instruction.
   140  **CallRecord** | **string** | Whether to record both legs of a call when executing a Call instruction or which leg to record.
   141  **CallTimeout** | **int** | Timeout for call when executing a Call instruction.
   142  **CallTo** | **string** | The Contact URI of the worker when executing a Call instruction.  Can be the URI of the Twilio Client, the SIP URI for Programmable SIP, or the [E.164](https://www.twilio.com/docs/glossary/what-e164) formatted phone number, depending on the destination.
   143  **CallUrl** | **string** | TwiML URI executed on answering the worker's leg as a result of the Call instruction.
   144  **CallStatusCallbackUrl** | **string** | The URL to call  for the completed call event when executing a Call instruction.
   145  **CallAccept** | **bool** | Whether to accept a reservation when executing a Call instruction.
   146  **RedirectCallSid** | **string** | The Call SID of the call parked in the queue when executing a Redirect instruction.
   147  **RedirectAccept** | **bool** | Whether the reservation should be accepted when executing a Redirect instruction.
   148  **RedirectUrl** | **string** | TwiML URI to redirect the call to when executing the Redirect instruction.
   149  **To** | **string** | The Contact URI of the worker when executing a Conference instruction. Can be the URI of the Twilio Client, the SIP URI for Programmable SIP, or the [E.164](https://www.twilio.com/docs/glossary/what-e164) formatted phone number, depending on the destination.
   150  **From** | **string** | The Caller ID of the call to the worker when executing a Conference instruction.
   151  **StatusCallback** | **string** | The URL we should call using the `status_callback_method` to send status information to your application.
   152  **StatusCallbackMethod** | **string** | The HTTP method we should use to call `status_callback`. Can be: `POST` or `GET` and the default is `POST`.
   153  **StatusCallbackEvent** | [**[]TaskReservationEnumCallStatus**](TaskReservationEnumCallStatus.md) | The call progress events that we will send to `status_callback`. Can be: `initiated`, `ringing`, `answered`, or `completed`.
   154  **Timeout** | **int** | Timeout for call when executing a Conference instruction.
   155  **Record** | **bool** | Whether to record the participant and their conferences, including the time between conferences. The default is `false`.
   156  **Muted** | **bool** | Whether the agent is muted in the conference. The default is `false`.
   157  **Beep** | **string** | Whether to play a notification beep when the participant joins or when to play a beep. Can be: `true`, `false`, `onEnter`, or `onExit`. The default value is `true`.
   158  **StartConferenceOnEnter** | **bool** | Whether to start the conference when the participant joins, if it has not already started. The default is `true`. If `false` and the conference has not started, the participant is muted and hears background music until another participant starts the conference.
   159  **EndConferenceOnExit** | **bool** | Whether to end the conference when the agent leaves.
   160  **WaitUrl** | **string** | The URL we should call using the `wait_method` for the music to play while participants are waiting for the conference to start. The default value is the URL of our standard hold music. [Learn more about hold music](https://www.twilio.com/labs/twimlets/holdmusic).
   161  **WaitMethod** | **string** | The HTTP method we should use to call `wait_url`. Can be `GET` or `POST` and the default is `POST`. When using a static audio file, this should be `GET` so that we can cache the file.
   162  **EarlyMedia** | **bool** | Whether to allow an agent to hear the state of the outbound call, including ringing or disconnect messages. The default is `true`.
   163  **MaxParticipants** | **int** | The maximum number of participants in the conference. Can be a positive integer from `2` to `250`. The default value is `250`.
   164  **ConferenceStatusCallback** | **string** | The URL we should call using the `conference_status_callback_method` when the conference events in `conference_status_callback_event` occur. Only the value set by the first participant to join the conference is used. Subsequent `conference_status_callback` values are ignored.
   165  **ConferenceStatusCallbackMethod** | **string** | The HTTP method we should use to call `conference_status_callback`. Can be: `GET` or `POST` and defaults to `POST`.
   166  **ConferenceStatusCallbackEvent** | [**[]TaskReservationEnumConferenceEvent**](TaskReservationEnumConferenceEvent.md) | The conference status events that we will send to `conference_status_callback`. Can be: `start`, `end`, `join`, `leave`, `mute`, `hold`, `speaker`.
   167  **ConferenceRecord** | **string** | Whether to record the conference the participant is joining or when to record the conference. Can be: `true`, `false`, `record-from-start`, and `do-not-record`. The default value is `false`.
   168  **ConferenceTrim** | **string** | How to trim the leading and trailing silence from your recorded conference audio files. Can be: `trim-silence` or `do-not-trim` and defaults to `trim-silence`.
   169  **RecordingChannels** | **string** | The recording channels for the final recording. Can be: `mono` or `dual` and the default is `mono`.
   170  **RecordingStatusCallback** | **string** | The URL that we should call using the `recording_status_callback_method` when the recording status changes.
   171  **RecordingStatusCallbackMethod** | **string** | The HTTP method we should use when we call `recording_status_callback`. Can be: `GET` or `POST` and defaults to `POST`.
   172  **ConferenceRecordingStatusCallback** | **string** | The URL we should call using the `conference_recording_status_callback_method` when the conference recording is available.
   173  **ConferenceRecordingStatusCallbackMethod** | **string** | The HTTP method we should use to call `conference_recording_status_callback`. Can be: `GET` or `POST` and defaults to `POST`.
   174  **Region** | **string** | The [region](https://support.twilio.com/hc/en-us/articles/223132167-How-global-low-latency-routing-and-region-selection-work-for-conferences-and-Client-calls) where we should mix the recorded audio. Can be:`us1`, `ie1`, `de1`, `sg1`, `br1`, `au1`, or `jp1`.
   175  **SipAuthUsername** | **string** | The SIP username used for authentication.
   176  **SipAuthPassword** | **string** | The SIP password for authentication.
   177  **DequeueStatusCallbackEvent** | **[]string** | The Call progress events sent via webhooks as a result of a Dequeue instruction.
   178  **PostWorkActivitySid** | **string** | The new worker activity SID after executing a Conference instruction.
   179  **SupervisorMode** | **string** | 
   180  **Supervisor** | **string** | The Supervisor SID/URI when executing the Supervise instruction.
   181  **EndConferenceOnCustomerExit** | **bool** | Whether to end the conference when the customer leaves.
   182  **BeepOnCustomerEntrance** | **bool** | Whether to play a notification beep when the customer joins.
   183  **JitterBufferSize** | **string** | The jitter buffer size for conference. Can be: `small`, `medium`, `large`, `off`.
   184  
   185  ### Return type
   186  
   187  [**TaskrouterV1TaskReservation**](TaskrouterV1TaskReservation.md)
   188  
   189  ### Authorization
   190  
   191  [accountSid_authToken](../README.md#accountSid_authToken)
   192  
   193  ### HTTP request headers
   194  
   195  - **Content-Type**: application/x-www-form-urlencoded
   196  - **Accept**: application/json
   197  
   198  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
   199  [[Back to Model list]](../README.md#documentation-for-models)
   200  [[Back to README]](../README.md)
   201