AD-10125 Update Swagger 2.2

[MichalZawilski]

No description provided.

[Copilot]

Copilot review overview

🟡 Changes recommended

Resolve the documented security discovery, error schema, ETag, and UUID validation issues.

Review effort: Lite
Findings: 3

Open (3)

• Fixed discovery URL conflicts with production and sandbox servers · New
• ETag headers are optional, preventing documented conditional polling · New
• Error response schema removed from unchanged operation contract · New

What changed in this PR

Updates the MLA Participant API specification from v2.1 to v2.2 for Raidiam Connect.

Changes:

• Updates servers, endpoint path, authentication, and scopes.
• Adds conditional polling, ETags, 304 Not Modified, and interaction IDs.
• Refines response schemas, examples, and validation.

File	Summary
MLAPartcipantAPI/​mla-participant.yaml	Defines the v2.2 MLA Participant API contract.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Copilot review overview

🟡 Changes recommended

Environment-specific authentication and required response-header semantics are not represented correctly in the machine-readable contract.

Review effort: Balanced
Findings: 1 · 1

Open (2)

• Mark 401 WWW-Authenticate header as required · New
• Incorrect compatibility claims for v2.2 response changes · New

Resolved since last review (3)

• Error response schema removed from unchanged operation contract
• ETag headers are optional, preventing documented conditional polling
• Fixed discovery URL conflicts with production and sandbox servers

Previously missed (1)

In code that hasn't changed since last review

Mark guaranteed 304 interaction ID header as required

MLAPartcipantAPI/​mla-participant.yaml:134

This 304 contract says the interaction ID is always echoed or generated, but the header remains optional by default in OpenAPI. Add required: true to match that guarantee.

This issue also appears in the following locations of the same file:

• line 142
• line 152
• line 168

[OBPeteS]

Agreed that this would be left as optional

[OBPeteS]

Agreed to preserve as-is