Skip to main content
Verify the version tags to ensure you are consuming the intended content or, complete the latest version.

Exposing an application as a service

The two most common ways to expose your application as a service are either to leverage the Pega API or create a web service with the Service Wizard.

Conceptually, these two options work the same way: a request is made to a URL, and a response is returned. The difference is how you communicate with the service.

The Pega API

The Pega API provides a standard set of services that includes new case creation, assignment processing, and access to data pages. These built-in REST/JSON services enable the rapid implementation of Pega-powered mobile and client applications.

rest service

You can call any of the Pega API services by using standard HTTP methods (for example, GET, POST, or PUT). Refer to the Pega API resources page in Dev Studio or App Studio (in Dev Studio, click the Resources menu and select Pega API; in App Studio, click Channels and select API to see details of the request and response data requirements.)

Resourses pega api updates

This documentation is also available in JSON format in the Docs API (GET/docs).

Resource Description
Assignment API Provides the ability to obtain a list of assignments for a user, obtain the details of any specific assignment, and perform an assignment action.
Authenticate API Allows you to verify user credentials.
Cases API Provides the ability to obtain a list of cases for a user, create a new case, obtain case details, and update a specific case.
Casetypes API Provides the ability to obtain a list of case types for the authenticated user.
Data API Facilitates the process of obtaining the contents of a data page and obtaining the metadata for a specific data page.
Docs API Provides access to the complete documentation for the Pega API.

For more information about the Pega API, see Integrating with Pega APIs and services.

The Service Wizard

For most situations, Pega API covers service needs using the REST protocol. Pega Platform™ also supports the creation of services using other protocols through the Service Wizard. Creating a service through any method exposes a Pega Platform data page securely. However, it is best practice to use Pega API when possible.

Access the Service Wizard by clicking Configure > Integration > Services > Service Wizard. The Service Wizard generates rules and data types for services that perform one of the following tasks:

Service purpose Description
Create and manage work Create new work items or perform actions on a work object such as a flow action.
Invoke existing activity rules Call an activity and select service parameters.
Process input or output data Map data to or from the clipboard.

The Service Wizard completes each of these tasks through five general steps, for which the Service Wizard displays a sequence of forms to fill out that define the appropriate service rules and the supporting data types. Some service purposes may contain more sub-steps than others due to the nature of their configuration. When you finish, the Service Wizard displays the values you specified and allows you to review and modify the values of those settings before creating the service rules.

In the following image, click the + icons to learn more about the five general steps of the Service Wizard.

Check your knowledge with the following interaction.


If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice