It should work. I did multiple time the import yaml and then build the API appication based on the yaml. Though the ACE validate the openapi structure and it gives error if there any issue in improted yaml. To fix that - you have to apply generic fix for the open api yaml. May below suggestion may help you to fix the issue or do some search you will get the fix. it is not related to ACE tollkit.
The error message "The OpenAPI document 'openapi-appconnectenterprise.yaml' resource path '/apiv2/servers/{server}/dot-net-app-domains/{dot-net-app-domain}' does not contain the path parameter '{dotnetappdomain}'" indicates a mismatch between the path parameter defined in the URL path and the parameters actually declared within the OpenAPI document for that specific path.
Specifically, the path uses {dot-net-app-domain} as a placeholder for a path parameter, but the OpenAPI definition for this path is expecting a parameter named {dotnetappdomain} (without hyphens).
To resolve this issue, one of the following corrections is required:
Modify the path in the OpenAPI document: Change the path string from /apiv2/servers/{server}/dot-net-app-domains/{dot-net-app-domain} to /apiv2/servers/{server}/dot-net-app-domains/{dotnetappdomain} to match the declared parameter name.
Modify the parameter definition in the OpenAPI document: If the path string must remain as /apiv2/servers/{server}/dot-net-app-domains/{dot-net-app-domain}, then the corresponding parameter definition within the parameters section for this path must be updated to use name: dot-net-app-domain instead of name: dotnetappdomain.
------------------------------
Somnath Ghosh
Technology Architect
Cognizant
Stamford CT
------------------------------
Original Message:
Sent: Tue August 12, 2025 07:14 AM
From: Peter Von Hirschfeld
Subject: Error importng Administration .yaml file for Rest API
Hi
I'm trying to create a new REST API in my toolkit for the administration REST API by importing the .yaml file supplied with ACE 12
(/integration/mqsi/12.0.12.15/server/nodejs_all/node_modules/@ibm-app-connect/ace-admin-api/docs/node/openapi-appconnectenterprise.yaml)
I fixed the error that complained about response codes of 5xx (vs 500), but then I get:
The OpenAPI document 'openapi-appconnectenterprise.yaml' resource path '/apiv2/servers/{server}/dot-net-app-domains/{dot-net-app-domain}' does not contain the path parameter '{dotnetappdomain}'.
Has anyone successfully imported this .yaml file into a new REST API in a toolkit?
------------------------------
Peter Von Hirschfeld
------------------------------