LAB-1922: Update OpenAPI specification for the GET template endpoint

[alyssarcano]

Enhances the OpenAPI specification for the GET template endpoint by adding support for a request parameter used to retrieve a specific template.

[Copilot]

Pull request overview

Updates the Data Gateway OpenAPI spec to support retrieving a specific Cloud Matrix assessment template by name.

Changes:

• Added a reusable templateName path parameter under components.parameters.
• Updated the Cloud Matrix template GET endpoint to use /Api/CloudMatrix/Template/{templateName} and reference the new parameter.
• Adjusted response documentation (new 400 response and updated example/summary text).

Comments suppressed due to low confidence (1)

specs/Data-Gateway.json:9142

• This path item is /Api/CloudMatrix/Template/{templateName}, but the post operation does not declare the required templateName path parameter (path params must be defined at the path-item level or on every operation). As written, the OpenAPI document is invalid for many validators/generators. Either add the templateName parameter to the path-item (so it applies to both GET and POST), add it to the POST operation, or move the POST back to a non-parameterized path if it isn’t meant to use {templateName}.

            "post": {
                "description": "Add or update a value assessment template. When the specified template name exists, it will overwrite the existing template JSON file in blob storage.\n\nThis endpoint is only accessible from the `SHI` and `SHI Lab` tenants and requires the `CloudMatrix.ReadWrite.All` scope (permission).",
                "operationId": "/Api/CloudMatrix/Template/Post",
                "requestBody": {

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.