Skip to main content


Generating OpenAPI Specification documentation for application-specific REST APIs

Suggest edit Updated on January 29, 2021

You can list service packages that contain REST services in your application rule to include their OpenAPI Specification (OAS) documentation in your application's OAS documentation. All of the services that you list are documented together in a single application OAS landing page, which you can view in the application's API channel.

Before you begin: To ensure that you generate accurate and useful OAS documentation, review the Best practices for generating OpenAPI Specification documentation.
  1. In the header of Dev Studio, click the name of the application, and then click Definition.

  2. On the Application form, click the Integration & security tab.

  3. In the Service Packages section, select the service packages that you want to document:

    • To add a package, click the Add item icon, and then select a service package from the list.
    • To remove a service package, in the row for that service package, click the Delete icon.
  4. Click Save.

Confirm that the OAS documentation for the REST services included in your service package was generated. For more information, see Viewing application-specific REST APIs.
Did you find this content helpful? YesNo

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us