How to create OPENAPI Specification 3.x compliant API Specs with Genesys as API Provider

Platform API
1

Hi Guys,

I need to initiate a call from internal org to Genesys Cloud using API Gateway (Azure DevOps).

for the above reason my API team is asking me to create OPENAPI Specification 3.x compliant API Specs with Genesys as API Provider which they will run against swagger editor to ensure the YAML or open API format is readable.

I need some assistance to figure out how to perform the above step.

Would appreciate your help.

2

Hello,

We currently only expose an OpenAPI 2.0 Definition for the Genesys Cloud Platform API.

There is a project planned later this year to expose an Open API 3.x definition.

Until then, you can work to manually convert (or use a third party tool) from Open API 2.0 definition to Open API 3.x Definition.

Regards,

3

@Jerome.Saint-Marc Thank you this helps. only thing I am worried about is the definition includes all the API tags/paths. is there a way to customize the file to only include the API's and related model which needs to be used for API gateway.

4

Hello,

The definition includes all public Platform API endpoints. That's standard.
You can use a text editor (or use a third party tool or library) to filter what you need.

Regards,

5

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.