Add unassign job route (#19470)

* Add unassign job route

* Fix errors

* Add custom words

* Upgrade version

* Revert to previous API version

Author: cparisineti

custom-words.txt

@@ -2603,6 +2603,9 @@ getazresiliencystatus
 providerport
 spaceallocationparameter
 cadl
+unassignment
+unassign
+Unassigns
 enrollmentgroups
 scheduledjobs
 getdevices
@@ -2613,4 +2616,4 @@ setx
 verifyx
 removex
 generateverificationcodex
-favorited
+favorited

specification/communication/data-plane/JobRouter/preview/2021-10-20-preview2/communicationservicejobrouter.json

@@ -1052,6 +1052,56 @@
         }
       }
     },
+    "/routing/jobs/{jobId}/assignments/{assignmentId}:unassign": {
+      "post": {
+        "tags": [
+          "Jobs"
+        ],
+        "summary": "Un-assign a job.",
+        "operationId": "JobRouter_UnassignJobAction",
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "jobId",
+            "description": "Id of the job to unassign",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "path",
+            "name": "assignmentId",
+            "description": "Id of the assignment to unassign",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/CommunicationErrorResponse"
+            }
+          },
+          "200": {
+            "description": "Success",
+            "schema": {
+              "$ref": "#/definitions/UnassignJobResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Unassigns a job": {
+            "$ref": "./examples/Jobs_UnassignJob.json"
+          }
+        }
+      }
+    },
     "/routing/workers/{workerId}/offers/{offerId}:accept": {
       "post": {
         "tags": [
@@ -3322,6 +3372,24 @@
       },
       "x-ms-discriminator-value": "static"
     },
+    "UnassignJobResponse": {
+      "required": [
+        "jobId",
+        "unassignmentCount"
+      ],
+      "type": "object",
+      "properties": {
+        "jobId": {
+          "description": "The Id of the job unassigned.",
+          "type": "string"
+        },
+        "unassignmentCount": {
+          "format": "int32",
+          "description": "The number of times a job is unassigned. At a maximum 3.",
+          "type": "integer"
+        }
+      }
+    },
     "WaitTimeExceptionTrigger": {
       "description": "Trigger for an exception action on exceeding wait time",
       "required": [

specification/communication/data-plane/JobRouter/preview/2021-10-20-preview2/examples/Jobs_UnassignJob.json

@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "endpoint": "https://contoso.westus.communications.azure.com",
+    "api-version": "2021-10-20_preview2",
+    "jobId": "8780b28c-7079-4de1-9143-4d369289e958",
+    "assignmentId": "1d5896f3-8b54-40be-82d3-910323f5e2af"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "jobId": "8780b28c-7079-4de1-9143-4d369289e958",
+        "unassignmentCount": 1
+      }
+    }
+  }
+}