Port OPS + Recording changes to GA5

specification/communication/data-plane/CallAutomation/stable/2025-05-15/communicationservicescallautomation.json

@@ -1,4 +1,4 @@
 {
   "swagger": "2.0",
   "info": {
     "version": "2025-05-15",
@@ -1496,6 +1496,12 @@
             "schema": {
               "$ref": "#/definitions/RecordingStateResponse"
             }
+          },
+          "202": {
+            "description": "The service has accepted the StartCallRecording request and will begin processing it. You will receive either a StartRecordingFailed event or RecordingStateChanged event at your specified callback URI to update you on the status of the request.",
+            "schema": {
+              "$ref": "#/definitions/RecordingStateResponse"
+            }
           }
         },
         "x-ms-examples": {
@@ -1702,55 +1708,33 @@
         "transcriptionOptions": {
           "$ref": "#/definitions/TranscriptionOptions",
           "description": "Transcription Options."
+        },
+        "teamsAppSource": {
+          "$ref": "#/definitions/MicrosoftTeamsAppIdentifierModel",
+          "description": "The identifier of the source for creating call with Teams resource account ID."
         }
       }
     },
-    "WebSocketMediaStreamingOptions": {
-      "description": "Represents the options for WebSocket transport.",
-      "required": [
-        "transportType",
-        "audioChannelType"
-      ],
-      "type": "object",
-      "allOf": [
-        {
-          "$ref": "#/definitions/MediaStreamingOptions"
-        }
+    "AudioFormat": {
+      "description": "The audio format used for encoding, including sample rate and channel type. The default is Pcm16KMono.",
+      "enum": [
+        "pcm16KMono",
+        "pcm24KMono"
       ],
-      "properties": {
-        "transportUrl": {
-          "description": "The transport URL for media streaming.",
-          "type": "string"
-        },
-        "contentType": {
-          "$ref": "#/definitions/MediaStreamingContentType"
-        },
-        "startMediaStreaming": {
-          "description": "A value indicating whether the media streaming should start immediately after the call is answered.",
-          "type": "boolean"
-        },
-        "enableBidirectional": {
-          "description": "A value indicating whether bidirectional streaming is enabled.",
-          "type": "boolean"
-        },
-        "audioFormat": {
-          "$ref": "#/definitions/AudioFormat"
-        },
-        "enableDtmfTones": {
-          "description": "A value that indicates whether to stream the DTMF tones.",
-          "type": "boolean"
-        }
-      },
-      "x-ms-discriminator-value": "websocket"
+      "type": "string",
+      "x-ms-enum": {
+        "name": "AudioFormat",
+        "modelAsString": true
+      }
     },
     "CommunicationIdentifierModel": {
-      "$ref": "../../../Common/stable/2023-11-15/common.json#/definitions/CommunicationIdentifierModel"
+      "$ref": "../../../Common/preview/2025-03-15-preview/common.json#/definitions/CommunicationIdentifierModel"
     },
     "PhoneNumberIdentifierModel": {
-      "$ref": "../../../Common/stable/2023-11-15/common.json#/definitions/PhoneNumberIdentifierModel"
+      "$ref": "../../../Common/preview/2025-03-15-preview/common.json#/definitions/PhoneNumberIdentifierModel"
     },
     "CommunicationUserIdentifierModel": {
-      "$ref": "../../../Common/stable/2023-11-15/common.json#/definitions/CommunicationUserIdentifierModel"
+      "$ref": "../../../Common/preview/2025-03-15-preview/common.json#/definitions/CommunicationUserIdentifierModel"
     },
     "CallIntelligenceOptions": {
       "description": "AI options for the call.",
@@ -1820,61 +1804,58 @@
       },
       "discriminator": "transportType"
     },
-    "WebSocketTranscriptionOptions": {
+    "WebSocketMediaStreamingOptions": {
       "description": "Represents the options for WebSocket transport.",
       "required": [
         "transportType",
-        "locale"
+        "audioChannelType"
       ],
       "type": "object",
       "allOf": [
         {
-          "$ref": "#/definitions/TranscriptionOptions"
+          "$ref": "#/definitions/MediaStreamingOptions"
         }
       ],
       "properties": {
         "transportUrl": {
-          "description": "The URL used for live transcription transport.",
+          "description": "The transport URL for media streaming.",
           "type": "string"
         },
-        "speechModelEndpointId": {
-          "description": "The ID of the deployed custom model in GUID format. The GUID is generated by Azure Speech Studio, e.g., a259c255-1cdw-4ed7-a693-dd58563b6f6a.",
-          "type": "string"
+        "contentType": {
+          "$ref": "#/definitions/MediaStreamingContentType"
         },
-        "startTranscription": {
-          "description": "Indicates whether the transcription should start immediately after the call is answered.",
+        "startMediaStreaming": {
+          "description": "A value indicating whether the media streaming should start immediately after the call is answered.",
           "type": "boolean"
         },
-        "enableIntermediateResults": {
-          "description": "Enables intermediate results for the transcribed speech.",
+        "enableBidirectional": {
+          "description": "A value indicating whether bidirectional streaming is enabled.",
+          "type": "boolean"
+        },
+        "audioFormat": {
+          "$ref": "#/definitions/AudioFormat"
+        },
+        "enableDtmfTones": {
+          "description": "A value that indicates whether to stream the DTMF tones.",
           "type": "boolean"
         }
       },
       "x-ms-discriminator-value": "websocket"
     },
-    "MicrosoftTeamsUserIdentifierModel": {
-      "$ref": "../../../Common/stable/2023-11-15/common.json#/definitions/MicrosoftTeamsUserIdentifierModel"
+    "MicrosoftTeamsAppIdentifierModel": {
+      "$ref": "../../../Common/preview/2025-03-15-preview/common.json#/definitions/MicrosoftTeamsAppIdentifierModel"
     },
-    "AudioFormat": {
-      "description": "The audio format used for encoding, including sample rate and channel type. The default is Pcm16KMono.",
-      "enum": [
-        "pcm16KMono",
-        "pcm24KMono"
-      ],
-      "type": "string",
-      "x-ms-enum": {
-        "name": "AudioFormat",
-        "modelAsString": true
-      }
+    "MicrosoftTeamsUserIdentifierModel": {
+      "$ref": "../../../Common/preview/2025-03-15-preview/common.json#/definitions/MicrosoftTeamsUserIdentifierModel"
     },
-    "MicrosoftTeamsAppIdentifierModel": {
-      "$ref": "../../../Common/stable/2023-11-15/common.json#/definitions/MicrosoftTeamsAppIdentifierModel"
+    "TeamsExtensionUserIdentifierModel": {
+      "$ref": "../../../Common/preview/2025-03-15-preview/common.json#/definitions/TeamsExtensionUserIdentifierModel"
     },
     "CommunicationErrorResponse": {
-      "$ref": "../../../Common/stable/2023-11-15/common.json#/definitions/CommunicationErrorResponse"
+      "$ref": "../../../Common/preview/2025-03-15-preview/common.json#/definitions/CommunicationErrorResponse"
     },
     "CommunicationError": {
-      "$ref": "../../../Common/stable/2023-11-15/common.json#/definitions/CommunicationError"
+      "$ref": "../../../Common/preview/2025-03-15-preview/common.json#/definitions/CommunicationError"
     },
     "CallConnectionStateModel": {
       "description": "The state of the call connection.",
@@ -3015,14 +2996,15 @@
     },
     "StartCallRecordingRequest": {
       "description": "The request payload start for call recording operation with call locator.",
-      "required": [
-        "callLocator"
-      ],
       "type": "object",
       "properties": {
         "callLocator": {
           "$ref": "#/definitions/CallLocator",
-          "description": "The call locator."
+          "description": "The call locator. (Only one of callLocator or callConnectionId to be used)"
+        },
+        "callConnectionId": {
+          "description": "The call connection Id. (Only one of callLocator or callConnectionId to be used)",
+          "type": "string"
         },
         "recordingStateCallbackUri": {
           "description": "The uri to send notifications to.",
@@ -4196,6 +4178,24 @@
         }
       }
     },
+    "StartRecordingFailed": {
+      "type": "object",
+      "properties": {
+        "callConnectionId": {
+          "description": "The call connection Id.",
+          "type": "string"
+        },
+        "correlationId": {
+          "description": "Correlation Id for event to call correlation.",
+          "type": "string"
+        },
+        "recordingId": {
+          "description": "The call recording Id.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
     "TranscriptionFailed": {
       "type": "object",
       "properties": {
@@ -4365,6 +4365,38 @@
           "description": "Contains the resulting SIP code, sub-code and message."
         }
       }
+    },
+    "WebSocketTranscriptionOptions": {
+      "description": "Represents the options for WebSocket transport.",
+      "required": [
+        "transportType",
+        "locale"
+      ],
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/TranscriptionOptions"
+        }
+      ],
+      "properties": {
+        "transportUrl": {
+          "description": "The URL used for live transcription transport.",
+          "type": "string"
+        },
+        "speechModelEndpointId": {
+          "description": "The ID of the deployed custom model in GUID format. The GUID is generated by Azure Speech Studio, e.g., a259c255-1cdw-4ed7-a693-dd58563b6f6a.",
+          "type": "string"
+        },
+        "startTranscription": {
+          "description": "Indicates whether the transcription should start immediately after the call is answered.",
+          "type": "boolean"
+        },
+        "enableIntermediateResults": {
+          "description": "Enables intermediate results for the transcribed speech.",
+          "type": "boolean"
+        }
+      },
+      "x-ms-discriminator-value": "websocket"
     }
   },
   "parameters": {