Deactivate Registration and Reactivate Registration Pega Process Fabric Hub endpoints
The Deactivate Registration REST API helps you stop data synchronization between your remote application and the Pega Process Fabric Hub, for example, when the application is currently out of use. When your business process requires you to resume publishing assignments from the application to the Pega Process Fabric Hub, you can call the Reactivate Registration REST API.
For example, you can deactivate an application to review job candidates when your organization plans to stop hiring new employees. When the business circumstances change and the organization resumes the hiring process, you can reactivate the application.Deactivate Registration REST API
You invoke the Deactivate Registration REST API by calling the following endpoint:
POST /registrations/{ID}/actions/disablesync
After you call this REST API, the Pega Process Fabric Hub stops accepting any data that the remote application publishes, and the Registered applications landing page displays the application with the Disabled - Sync Stopped status. The Pega Process Fabric Hub does not display assignments from a disabled application across worklists, work queues, and reports, and ignores the assignments from the application in the Next Best Work algorithm.
Before you call the Deactivate Registration REST API, consider the following factors:
- If you try to synchronize data with an application that has the Disabled - Sync Stopped status by invoking data synchronization APIs, the API responds with the HTTP response code 403, which means that the access to the resource is unavailable.
- The Deactivate Registration REST API returns an entire registration instance as a response.
- If an error occurs, the response includes an appropriate status code and error message.
The following table shows a sample response body for the Deactivate Registration endpoint:
Element | Value |
Request URL | https://vlenghydcnt17263-processfabrichub.lab.pega.com/prweb/api/ppf/v1/registrations/REG-22951/actions/disablesync |
Request headers | Authorization: Bearer access
token |
Request body | Not applicable |
Response status | 200 |
Response body |
|
For more information, see the Swagger documentation.
Reactivate Registration REST API
You invoke the Reactivate Registration REST API by calling the following endpoint:
POST /registrations/{ID}/actions/enablesync
After you call this REST API, the application gets the Open-ResyncProgress status, and the Pega Process Fabric Hub accepts batch requests from the application. Batch requests include data about resources, such as assignments, worklists, work queues, and operators. After the process of resynchronizing resources finishes, the application moves to the Active state.
Before you call the Reactivate Registration REST API, consider the following factors:
- The Reactivate Registration REST API returns an entire registration instance as a response.
- If an error occurs, the response includes an appropriate status code and error message.
The following table shows a sample response body for the Reactivate Registration endpoint:
Element | Value |
Request URL | https://vlenghydcnt17263-processfabrichub.lab.pega.com/prweb/api/ppf/v1/registrations/REG-22951/actions/enablesync |
Request headers | Authorization: Bearer access token |
Request body | Not applicable |
Response status | 200 |
Response body |
|
For more information, see the Swagger documentation.
Previous topic Disable Registration and Enable Registration Pega Process Fabric Hub endpoints Next topic Delete Registration Pega Process Fabric Hub endpoint