2025-06-01 api version

specification/communication/data-plane/PhoneNumbers/readme.md

@@ -26,7 +26,16 @@ These are the global settings for the communicationservices.
 
 ```yaml
 openapi-type: data-plane
-tag: package-phonenumber-2025-04-15-preview
+tag: package-phonenumber-2025-06-01
+```
+
+### Tag: package-phonenumber-2025-06-01
+These settings apply only when `--tag=package-phonenumber-2025-06-01` is specified on the command line.
+```yaml $(tag) == 'package-phonenumber-2025-06-01'
+input-file:
+  - stable/2025-06-01/phonenumbers.json
+title:
+  Azure Communication Services
 ```
 
 ### Tag: package-phonenumber-2025-04-01

specification/communication/data-plane/PhoneNumbers/stable/2025-06-01/examples/BrowseAvailablePhoneNumbers.json

@@ -0,0 +1,63 @@
+{
+  "parameters": {
+    "api-version": "2025-06-01",
+    "endpoint": "https://resourcename.communication.azure.com",
+    "countryCode": "US",
+    "phoneNumbersBrowseRequest": {
+      "phoneNumberType": "geographic",
+      "capabilities": {
+        "calling": "outbound",
+        "sms": "none"
+      },
+      "assignmentType": "person",
+      "phoneNumberPrefixes": [
+        "1425",
+        "1626"
+      ]
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "phoneNumbers": [
+          {
+            "id": "14254567890",
+            "countryCode": "US",
+            "phoneNumber": "+14254567890",
+            "capabilities": {
+              "calling": "outbound",
+              "sms": "none"
+            },
+            "phoneNumberType": "geographic",
+            "assignmentType": "person",
+            "cost": {
+              "amount": 1,
+              "currencyCode": "USD",
+              "billingFrequency": "monthly"
+            },
+            "status": "available",
+            "isAgreementToNotResellRequired": false
+          },
+          {
+            "id": "16264567890",
+            "countryCode": "US",
+            "phoneNumber": "+16264567890",
+            "capabilities": {
+              "calling": "outbound",
+              "sms": "none"
+            },
+            "phoneNumberType": "geographic",
+            "assignmentType": "person",
+            "cost": {
+              "amount": 1,
+              "currencyCode": "USD",
+              "billingFrequency": "monthly"
+            },
+            "status": "available",
+            "isAgreementToNotResellRequired": false
+          }
+        ]
+      }
+    }
+  }
+}

specification/communication/data-plane/PhoneNumbers/stable/2025-06-01/examples/CreateOrUpdateReservation.json

@@ -0,0 +1,143 @@
+{
+  "parameters": {
+    "api-version": "2025-06-01",
+    "endpoint": "https://resourcename.communication.azure.com",
+    "reservationId": "65c18c7f-8074-4efb-a572-e0df127a9964",
+    "reservation": {
+      "phoneNumbers": {
+        "11234561230": {
+          "countryCode": "US",
+          "capabilities": {
+            "calling": "outbound",
+            "sms": "none"
+          },
+          "phoneNumberType": "geographic",
+          "assignmentType": "person"
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "65c18c7f-8074-4efb-a572-e0df127a9964",
+        "expiresAt": "2023-08-23T22:29:17.092Z",
+        "phoneNumbers": {
+          "11234561230": {
+            "id": "11234561230",
+            "countryCode": "US",
+            "phoneNumber": "+11234561230",
+            "capabilities": {
+              "calling": "outbound",
+              "sms": "none"
+            },
+            "phoneNumberType": "geographic",
+            "assignmentType": "person",
+            "cost": {
+              "amount": 1,
+              "currencyCode": "USD",
+              "billingFrequency": "monthly"
+            },
+            "status": "reserved",
+            "isAgreementToNotResellRequired": false
+          }
+        },
+        "status": "active"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "65c18c7f-8074-4efb-a572-e0df127a9964",
+        "expiresAt": "2023-08-23T22:29:17.092Z",
+        "phoneNumbers": {
+          "11234567890": {
+            "id": "11234567890",
+            "countryCode": "US",
+            "phoneNumber": "+11234567890",
+            "capabilities": {
+              "calling": "outbound",
+              "sms": "none"
+            },
+            "phoneNumberType": "geographic",
+            "assignmentType": "person",
+            "cost": {
+              "amount": 1,
+              "currencyCode": "USD",
+              "billingFrequency": "monthly"
+            },
+            "status": "reserved",
+            "isAgreementToNotResellRequired": false
+          },
+          "11234561230": {
+            "id": "11234561230",
+            "countryCode": "US",
+            "phoneNumber": "+11234561230",
+            "capabilities": {
+              "calling": "outbound",
+              "sms": "none"
+            },
+            "phoneNumberType": "geographic",
+            "assignmentType": "person",
+            "cost": {
+              "amount": 1,
+              "currencyCode": "USD",
+              "billingFrequency": "monthly"
+            },
+            "status": "reserved",
+            "isAgreementToNotResellRequired": false
+          }
+        },
+        "status": "active"
+      }
+    },
+    "207": {
+      "body": {
+        "id": "65c18c7f-8074-4efb-a572-e0df127a9964",
+        "expiresAt": "2023-08-23T22:29:17.092Z",
+        "phoneNumbers": {
+          "11234567890": {
+            "id": "11234567890",
+            "countryCode": "US",
+            "phoneNumber": "+11234567890",
+            "capabilities": {
+              "calling": "outbound",
+              "sms": "none"
+            },
+            "phoneNumberType": "geographic",
+            "assignmentType": "person",
+            "cost": {
+              "amount": 1,
+              "currencyCode": "USD",
+              "billingFrequency": "monthly"
+            },
+            "status": "reserved",
+            "isAgreementToNotResellRequired": false
+          },
+          "11234561230": {
+            "id": "11234561230",
+            "countryCode": "US",
+            "phoneNumber": "+11234561230",
+            "capabilities": {
+              "calling": "outbound",
+              "sms": "none"
+            },
+            "phoneNumberType": "geographic",
+            "assignmentType": "person",
+            "cost": {
+              "amount": 1,
+              "currencyCode": "USD",
+              "billingFrequency": "monthly"
+            },
+            "status": "error",
+            "error": {
+              "code": "FailedToReserveNumber",
+              "message": "Failed to add the number to the reservation."
+            },
+            "isAgreementToNotResellRequired": false
+          }
+        },
+        "status": "active"
+      }
+    }
+  }
+}

specification/communication/data-plane/PhoneNumbers/stable/2025-06-01/examples/DeleteOperation.json

@@ -0,0 +1,10 @@
+{
+  "parameters": {
+    "api-version": "2025-06-01",
+    "endpoint": "https://resourcename.communication.azure.com/",
+    "operationId": "search_my-operation-id"
+  },
+  "responses": {
+    "204": {}
+  }
+}

specification/communication/data-plane/PhoneNumbers/stable/2025-06-01/examples/DeleteReservation.json

@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "api-version": "2025-06-01",
+    "endpoint": "https://resourcename.communication.azure.com",
+    "reservationId": "65c18c7f-8074-4efb-a572-e0df127a9964"
+  },
+  "responses": {
+    "204": {
+      "headers": {}
+    }
+  }
+}

specification/communication/data-plane/PhoneNumbers/stable/2025-06-01/examples/GetAreaCodes.json

@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "api-version": "2025-06-01",
+    "endpoint": "https://resourcename.communication.azure.com/",
+    "countryCode": "CA",
+    "phoneNumberType": "geographic",
+    "locality": "Vancouver",
+    "administrativeDivision": "BC"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "areaCodes": [
+          {
+            "areaCode": "236"
+          },
+          {
+            "areaCode": "604"
+          }
+        ]
+      }
+    }
+  }
+}

specification/communication/data-plane/PhoneNumbers/stable/2025-06-01/examples/GetCountries.json

@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "api-version": "2025-06-01",
+    "endpoint": "https://resourcename.communication.azure.com/",
+    "header": {
+      "accept-language": "en-US"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "countries": [
+          {
+            "localizedName": "Canada",
+            "countryCode": "CA"
+          },
+          {
+            "localizedName": "United States",
+            "countryCode": "US"
+          }
+        ]
+      }
+    }
+  }
+}

specification/communication/data-plane/PhoneNumbers/stable/2025-06-01/examples/GetLocalities.json

@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "api-version": "2025-06-01",
+    "endpoint": "https://resourcename.communication.azure.com/",
+    "countryCode": "CA",
+    "phoneNumberType": "mobile",
+    "header": {
+      "accept-language": "en-US"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "phoneNumberLocalities": [
+          {
+            "localizedName": "Vancouver",
+            "administrativeDivision": {
+              "localizedName": "British Columbia",
+              "abbreviatedName": "BC"
+            }
+          },
+          {
+            "localizedName": "Toronto",
+            "administrativeDivision": {
+              "localizedName": "Ontario",
+              "abbreviatedName": "ON"
+            }
+          }
+        ]
+      }
+    }
+  }
+}

specification/communication/data-plane/PhoneNumbers/stable/2025-06-01/examples/GetOfferings.json

@@ -0,0 +1,57 @@
+{
+  "parameters": {
+    "api-version": "2025-06-01",
+    "endpoint": "https://resourcename.communication.azure.com/",
+    "countryCode": "CA",
+    "header": {
+      "accept-language": "en-US"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "phoneNumberOfferings": [
+          {
+            "phoneNumberType": "geographic",
+            "assignmentType": "person",
+            "availableCapabilities": {
+              "calling": "outbound",
+              "sms": "outbound"
+            },
+            "cost": {
+              "amount": 1.0,
+              "currencyCode": "USD",
+              "billingFrequency": "monthly"
+            }
+          },
+          {
+            "phoneNumberType": "geographic",
+            "assignmentType": "person",
+            "availableCapabilities": {
+              "calling": "inbound+outbound",
+              "sms": "outbound"
+            },
+            "cost": {
+              "amount": 1.0,
+              "currencyCode": "USD",
+              "billingFrequency": "monthly"
+            }
+          },
+          {
+            "phoneNumberType": "tollFree",
+            "assignmentType": "application",
+            "availableCapabilities": {
+              "calling": "none",
+              "sms": "outbound"
+            },
+            "cost": {
+              "amount": 2.0,
+              "currencyCode": "USD",
+              "billingFrequency": "monthly"
+            }
+          }
+        ]
+      }
+    }
+  }
+}