Release Review: ClickToDial r2.2 (rc Sync26)

CHANGELOG/CHANGELOG-r2.md

@@ -2,6 +2,7 @@
 
 <!-- TOC:START -->
 ## Table of Contents
+- [r2.2](#r22)
 - [r2.1](#r21)
 <!-- TOC:END -->
 
@@ -14,6 +15,72 @@ The below sections record the changes for each API version in each release as fo
 * for subsequent release-candidate(s), only the delta to the previous release-candidate
 * for a public release, the consolidated changes since the previous public release
 
+# r2.2
+
+## Release Notes
+
+This release candidate contains the definition and documentation of
+* click-to-dial 0.2.0-rc.2
+
+The API definition(s) are based on
+* Commonalities r4.4 (0.9.0)
+* Identity and Consent Management r4.2 (0.5.0)
+
+<!-- BEGIN:AUTOGENERATED:CANDIDATE_CHANGES -->
+> **Working area — candidate changes (auto-removed on merge)**
+> Copy relevant entries into the Breaking changes/Added/Changed/Fixed/Removed sections below. List breaking changes both in Breaking changes and in their normal change category.
+> You may edit this list while triaging; it will be removed on merge.
+> This working-area section is removed automatically when the PR is merged.
+
+<details>
+<summary>Candidate changes (auto-generated from merged PRs)</summary>
+
+## What's Changed
+* Release Automation: Post-release sync (r2.1) by @camara-release-automation[bot] in https://github.com/camaraproject/ClickToDial/pull/117
+* prepare r2.2 with Commonalities r4.4 by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/119
+* Sync common files from Commonalities r4.4 by @camara-release-automation[bot] in https://github.com/camaraproject/ClickToDial/pull/120
+* Align ClickToDial with Commonalities r4.4 by @YadingFang in https://github.com/camaraproject/ClickToDial/pull/122
+
+</details>
+<!-- END:AUTOGENERATED:CANDIDATE_CHANGES -->
+
+## click-to-dial 0.2.0-rc.2
+
+**click-to-dial 0.2.0-rc.2 is a release-candidate version of this API.**
+
+Changes documented below are compared to version 0.2.0-rc.1.
+
+- API definition **with inline documentation**:
+  - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r2.2/code/API_definitions/click-to-dial.yaml&nocors)
+  - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/ClickToDial/r2.2/code/API_definitions/click-to-dial.yaml)
+  - OpenAPI [YAML spec file](https://github.com/camaraproject/ClickToDial/blob/r2.2/code/API_definitions/click-to-dial.yaml)
+
+### Breaking changes
+
+* Restricted CreateCallRequest.sink to HTTPS URLs. Requests containing a non-HTTPS sink are rejected with 400 INVALID_ARGUMENT.
+
+### Added
+
+* Added 422 EVENT_NOTIFICATIONS_NOT_SUPPORTED for createCall when a request contains a sink but the API provider does not support event notification delivery. In this case, no call resource is created.
+
+### Changed
+
+* Aligned the ClickToDial API definition with Commonalities r4.4 / 0.9.0.
+* Restricted CreateCallRequest.sink to HTTPS URLs by reusing the Commonalities Sink schema.
+* Replaced the deprecated local generic 400, 401, 403, 404, and 409 error responses with the corresponding reusable Commonalities responses.
+
+### Fixed
+
+* Added the x-correlator parameter to the call status callback request and the x-correlator header to its successful '2XX' response.
+* Updated the mandatory additional error responses documentation to the canonical Commonalities r4.4 text.
+* Updated createCall test coverage for HTTPS-only sinks and unsupported event notification delivery.
+
+### Removed
+
+* Removed the duplicated local Sink schema and deprecated local generic error response components.
+
+**Full Changelog**: https://github.com/camaraproject/ClickToDial/compare/r2.1...r2.2
+
 # r2.1
 
 ## Release Notes