Skip to main content


Upgrading REST connectors sourced from a Global Resource Setting

Suggest edit Updated on January 29, 2021

Take advantage of all available configuration options for a URL by upgrading REST connectors with URLs that are sourced from a Global Resource Setting (GRS), for example, =D_GRSDemoProject.URL.

Note: Pega Platform version 8.5 and later no longer support using GRS syntax directly in a connector. Connectors created in earlier Pega Platform versions continue to function properly. However, saving a connector with a GRS results in an error.

As a best practice, use an application setting to control the values of the URL and the authentication profile of a REST connector. Application settings allow explicit configuration that takes into account the production levels, and if required, you can use GRS as part of the application setting configuration. For more information, see Creating an application setting.

  1. In Dev Studio, click RecordsSysAdminIntegration-ConnectorsConnect REST.

  2. Click on the REST connector that you want to upgrade.

  3. On the Service tab, click Upgrade to new endpoint configuration.

  4. In the Create application setting(s) window, create a new application setting:

    1. In the Owning ruleset field, enter the domain for the application setting. This value does not have to equal a ruleset name; it functions as a namespace.

    2. In the Name field, enter a name for the application setting.

    3. In the Short description field, enter text that describes the purpose of the application setting.

  5. Optional:

    Specify a category in the Category field.

    By default, the Value fields in the Value per production level section are populated with the GRS resource path.
  6. Click Submit. The Base URL field is populated with the application setting that you created.

  7. Click Save.

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