--- title: "Dialog transfer accept" method: POST path: "/calls/1/dialogs/{dialogId}/transfer/accept" tags: ["channels", "voice", "calls", "dialog-calls", "dialog-operations"] --- # Dialog transfer accept `POST /calls/1/dialogs/{dialogId}/transfer/accept` ## Request - Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from) - URL: `https://api.infobip.com/calls/1/dialogs/{dialogId}/transfer/accept` - Auth: one of: - API key in header `Authorization` - API key in header `Authorization` - HTTP basic - OAuth 2 - Client credentials - Token URL: `https://api.infobip.com/auth/1/oauth2/token` Accepts a dialog transfer request received in a `DIALOG_TRANSFER_REQUESTED` event. ## Path parameters - `dialogId` string, required ## Request body - 14b5f31f4f292db4a32c4e61928f9a47f8ff4c0a1c06a38af2c29ef9ca05095dDialogAcceptTransferRequest - `targetCallRequest` 5fc49137a7b003ca1d8c4957601417b8ed884356b7fbc49afe416dd5c098a0bdDialogCallRequest, required - `endpoint` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611CallEndpoint: Call endpoint. Represents a caller for the inbound calls and a callee for the outbound calls. - `type` 'PHONE' | 'SIP' | 'WEBRTC' | 'VIBER' | 'WHATSAPP' | 'WEBSOCKET' - `from` string: Caller identifier. Must be a number in the [E.164](https://en.wikipedia.org/wiki/E.164) format for calls to `PHONE`, a string for calls to `WEBRTC` or `SIP`, and a Viber Voice number for calls to `VIBER`. Field is mandatory for `VIBER` endpoint and calls to emergency numbers. - `fromDisplayName` string: Display name to show when placing calls towards WEBRTC endpoints. Can be any alphanumeric string. - `connectTimeout` integer: Time to wait, in seconds, before the called party answers the call. - `machineDetection` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611MachineDetectionRequest - `enabled` boolean, required: Indicates whether to enable answering machine detection. If set to true, answering machine detection will generate an event indicating if the call was answered by a human or a machine. - `messageDetectionTimeout` integer: Indicates maximum duration for detecting the end of the message when a answering machine is detected. If set to 0, no end of message detection will be done. Expressed in seconds. - `detectionTime` number, double: Indicates time in seconds during which answering machine detection will analyse the call before making a decision. Shorter detection time may come at the expense of accuracy. Must be lower than `messageDetectionTimeout` if `messageDetectionTimeout` is specified. - `customData` object: Custom data is used for storing call-specific data defined by the client. - `recording` 14b5f31f4f292db4a32c4e61928f9a47f8ff4c0a1c06a38af2c29ef9ca05095dDialogRecordingRequest - `recordingType` 'AUDIO' | 'AUDIO_AND_VIDEO', required: Recording type. - `dialogComposition` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611DialogRecordingComposition - `enabled` boolean: Indicates whether to create a single recording of both participants. If set to `true`, both participants are merged into a single audio or video file. Otherwise, both participants will have their own individual audio or video file. - `customData` object: Custom data. - `filePrefix` string: Custom name for the recording's zip file. Applicable only when SFTP server is enabled on [Voice settings page](https://portal.infobip.com/apps/voice/recording/settings). Using the same filePrefix will override the files on the SFTP server. For recordings without composition, `callId` and `fileId` will be appended to the `filePrefix` value. - `maxDuration` integer: Max duration in seconds. - `propagationOptions` 5fc49137a7b003ca1d8c4957601417b8ed884356b7fbc49afe416dd5c098a0bdDialogPropagationOptions - `childCallHangup` boolean: Flag indicating if the parent call should be terminated when the child call ends. - `childCallRinging` boolean: Flag indicating if a child call's ringing should be propagated to the parent call. The parent call must be `INBOUND`. Cannot be `true` when `ringbackGeneration` is enabled. - `ringbackGeneration` F9f4d06aa76c139ea87428e14c99b11f79a0ab9b330e26afc80d0c5a5ff1acbbRingbackGeneration: Option to generate a consistent local ringback tone, overriding remote ringing tones. It applies only to `INBOUND` parent calls in the `CALLING` state; otherwise, it is ignored. - `enabled` boolean: Flag indicating whether ringback generation is enabled. Cannot be `true` when `childCallRinging` is `true`. - `finalizeTransferOnFailure` boolean: Whether to finalize the transfer if establishing the target call fails. When `false`, the dialog remains in the `TRANSFERRING` state and the transfer can be retried. ## Response `200` Success - 5fc49137a7b003ca1d8c4957601417b8ed884356b7fbc49afe416dd5c098a0bdDialogResponse - `id` string: Unique dialog ID. - `callsConfigurationId` string: Calls Configuration ID. - `platform` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611Platform: Platform options. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management). - `entityId` string: Required to use entity in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management). - `applicationId` string: Required for application use in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management). - `state` 'CREATED' | 'PRE_ESTABLISHED' | 'ESTABLISHED' | 'FINISHED' | 'FAILED' | 'TRANSFERRING': Dialog state. - `startTime` string, date-time: Date and time for when the dialog has been created. - `establishTime` string, date-time: Date and time for when the dialog has been established. - `endTime` string, date-time: Date and time for when the dialog has been finished. - `parentCall` 431fb79b0e816230968e14ba1e1c6fadb75cfde9cb3c381f4217b2777f48153fCall - `id` string: Unique call ID. - `endpoint` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611CallEndpoint, required: Call endpoint. Represents a caller for the inbound calls and a callee for the outbound calls. - `type` 'PHONE' | 'SIP' | 'WEBRTC' | 'VIBER' | 'WHATSAPP' | 'WEBSOCKET' - `from` string: Caller ID. - `to` string: Callee ID. - `direction` 'INBOUND' | 'OUTBOUND': Call direction. - `state` 'CALLING' | 'RINGING' | 'PRE_ESTABLISHED' | 'ESTABLISHED' | 'FINISHED' | 'FAILED' | 'CANCELLED' | 'NO_ANSWER' | 'BUSY': Call state. - `media` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611MediaProperties - `audio` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611AudioMediaProperties: Audio media properties. - `muted` boolean: Indicates whether the end user can speak. - `userMuted` boolean: Indicates whether the end user muted himself. - `deaf` boolean: Indicates whether the end user can hear. - `video` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611VideoMediaProperties: Video media properties. - `camera` boolean: Indicates whether there is a video feed. - `screenShare` boolean: Indicates whether the end user is sharing their screen. - `blind` boolean: Indicates whether the end user can receive remote videos. - `startTime` string, date-time: Date and time for when the call has been created. - `answerTime` string, date-time: Date and time for when the call has been answered. - `endTime` string, date-time: Date and time for when the call has been finished. - `parentCallId` string: Parent call ID. - `machineDetection` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611MachineDetectionProperties: Properties of the events that provide Answering Machine Detection result. - `detectionResult` 'HUMAN' | 'MACHINE': Detected class during analysis of the call. Always returns either HUMAN or MACHINE. Use confidenceRating for a finer grained analysis result - `confidenceRating` object: A map representing the confidence rating for each detection class. The key is a tag indicating the detection class, and the value is a float between `0.0` and `1.0` representing the confidence rating. Possible classes are: `HUMAN`, `MACHINE`, `MUSIC`, `RINGING`, `NOISE`, `SILENCE` and `OTHER`. Each class confidence rating is independent from the other, thereby the sum of all confidence values may not equal 1.0. - `customData` object: Custom data. - `ringDuration` integer: Ringing duration in seconds. - `callsConfigurationId` string: Current calls configuration ID. - `platform` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611Platform: Platform options. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management). - `entityId` string: Required to use entity in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management). - `applicationId` string: Required for application use in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management). - `conferenceId` string: Current conference ID. - `customData` object: Custom data. - `dialogId` string: Dialog ID. - `externalId` string: Client defined call ID. - `childCall` 431fb79b0e816230968e14ba1e1c6fadb75cfde9cb3c381f4217b2777f48153fCall - `id` string: Unique call ID. - `endpoint` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611CallEndpoint, required: Call endpoint. Represents a caller for the inbound calls and a callee for the outbound calls. - `type` 'PHONE' | 'SIP' | 'WEBRTC' | 'VIBER' | 'WHATSAPP' | 'WEBSOCKET' - `from` string: Caller ID. - `to` string: Callee ID. - `direction` 'INBOUND' | 'OUTBOUND': Call direction. - `state` 'CALLING' | 'RINGING' | 'PRE_ESTABLISHED' | 'ESTABLISHED' | 'FINISHED' | 'FAILED' | 'CANCELLED' | 'NO_ANSWER' | 'BUSY': Call state. - `media` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611MediaProperties - `audio` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611AudioMediaProperties: Audio media properties. - `muted` boolean: Indicates whether the end user can speak. - `userMuted` boolean: Indicates whether the end user muted himself. - `deaf` boolean: Indicates whether the end user can hear. - `video` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611VideoMediaProperties: Video media properties. - `camera` boolean: Indicates whether there is a video feed. - `screenShare` boolean: Indicates whether the end user is sharing their screen. - `blind` boolean: Indicates whether the end user can receive remote videos. - `startTime` string, date-time: Date and time for when the call has been created. - `answerTime` string, date-time: Date and time for when the call has been answered. - `endTime` string, date-time: Date and time for when the call has been finished. - `parentCallId` string: Parent call ID. - `machineDetection` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611MachineDetectionProperties: Properties of the events that provide Answering Machine Detection result. - `detectionResult` 'HUMAN' | 'MACHINE': Detected class during analysis of the call. Always returns either HUMAN or MACHINE. Use confidenceRating for a finer grained analysis result - `confidenceRating` object: A map representing the confidence rating for each detection class. The key is a tag indicating the detection class, and the value is a float between `0.0` and `1.0` representing the confidence rating. Possible classes are: `HUMAN`, `MACHINE`, `MUSIC`, `RINGING`, `NOISE`, `SILENCE` and `OTHER`. Each class confidence rating is independent from the other, thereby the sum of all confidence values may not equal 1.0. - `customData` object: Custom data. - `ringDuration` integer: Ringing duration in seconds. - `callsConfigurationId` string: Current calls configuration ID. - `platform` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611Platform: Platform options. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management). - `entityId` string: Required to use entity in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management). - `applicationId` string: Required for application use in a send request for outbound traffic. Returned in notification events. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management). - `conferenceId` string: Current conference ID. - `customData` object: Custom data. - `dialogId` string: Dialog ID. - `externalId` string: Client defined call ID. ## Other responses - `400`: Bad request - `401`: Unauthorized - `403`: Forbidden - `404`: Not found - `429`: Too Many Requests - `500`: Internal Server Error --- [API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)