What is the x-apim-inline property added to definitions when importing OpenAPI spec?

Benjamin Talmard 0 Reputation points
2024-03-21T20:36:52.4133333+00:00

When importing a simple OpenAPI spec into an APIM API, it is adding the x-apim-inline property with the value true to most of the imported Definitions.

It is even creating definitions to basics types such as string or integer in order to add this x-apim-inline property. That creates dozen of what seems to be useless definition. Eg:

{
    "type": "string",
    "x-apim-inline": true
}

What does that mean? What can I do to avoid it?

Thanks a lot

Azure API Management
Azure API Management
An Azure service that provides a hybrid, multi-cloud management platform for APIs.
1,751 questions
{count} votes

1 answer

Sort by: Most helpful
  1. JananiRamesh-MSFT 21,171 Reputation points
    2024-03-31T06:52:51.5333333+00:00

    @Benjamin Talmard Thanks for your patience! I had a discussion internally and confirmed that this is by design, The x-apim-inline property is added by APIM to indicate that it did not generate a separate schema reference and instead "inlined" it into the object.

    do let me know incase of further queries, I would be happy to assist you.