Server-side

When you encounter an error, you can find basic information about the error in the response body of your DX API. However, for security reasons, the response body provides only a general statement and error category, without additional information such as error codes, exception numbers, or where the error was encountered.

You can collect more details about the request and response of your DX API with the DebugPegaAPI system setting. When you set DebugPegaAPI to true, your system captures information about API errors in the PEGA log. The change is effective immediately.The setting is set to false by default.

The DebugPegaAPI system setting is particularly useful for debugging page instructions and field security errors, for example, when the request body of your DX API consists of fields that are not configured in the case, or when you try to update or remove a list element that does not exist.

The PEGA log contains warnings, errors, and information messages about internal operations and, with DebugPegaAPI set to true, collects the following information about errors and exceptions encountered by DX APIs:

• Input values used in the request body of your DX APIs
• Actions performed by your DX APIs
• Fields in the view where your DX APIs encountered errors or exceptions
• Descriptions of the cause for errors or exceptions
• Error codes or exception numbers

For more information about opening and filtering logs, see Viewing logs.

By default, the PEGA log is filtered by your operator ID. When filtered by operator ID, the log shows only basic information for errors or exceptions of your DX APIs. To see more details, you need to use the overall view and use the search function.

The following log contains full details for a page instructions error:

(…) Processing Perform Assignment for input value : {“pageInstructions”:[{“pxObjClass”:”Code-MergeInstructions”,”listIndex”:”1”,”instruction”:”UPDATE”,”content”:”DELETE”,”content” (…)
(…) Performing CollectEmployeeInfo on ASSIGN-WORKLIST ODIGV0-TRAVELAPP-WORK B-2!COLLECTINFO_FLOW
(…) Applying UPDATE for .EmployeeList on the case.
(…) Applying DELETE for .EmployeeList on the case.
(…) API error for B-2: Pega_API_059: The Reference pyWorkPage.EmployeeList(5) is not valid. Accessing invalid index 5 whereas the list has 1 elements from Request (…)

To illustrate this error, an invalid request was sent in a controlled environment. The API is trying to update and delete an entry that does not exist.

Client-side

You can inspect the request/response traffic of your DX APIs with the developer tools in your browser. The developer tools in your browser help you examine, edit, and debug the HTML, CSS, and JavaScript code on the page on which you run your application. With these tools, you can also inspect which assets the page requested and how long they loaded.

For more information, see Browser developer tools.

To debug the traffic of your DX API, open the Network section of the Developer Tools that lists the endpoints called by your DX API. From the list of endpoints, you can examine the following:

• Headers, for example, to check if the cookie is invalid.
• Requests, for example, to inspect what data your APIs send.
• Responses, for example, to check if your APIs can access all necessary resources.
• Stack trace, for example, to check active stack frames prior to an exception.