Differences between DX API v1 and DX API v2

Pega DX API Version 1 and Version 2 apply to different scenarios. By learning about the differences between the two versions, you can decide which approach suits your use case better.

DX API Version 1 expands on the mashup experience by integrating Pega-based processes into existing channels, with complete control over how the external site renders the experience. DX API v1 directly translates the state of the screen in Pega UI to a REST message. This approach allows for the use of standard assets, such as sections and harnesses, and as a result, makes v1 the optimal choice for existing applications.

DX API Version 2 improves upon v1 by providing a significantly different approach that optimizes the number of messages (chattiness) and their structure. However, only applications that use the new view-based approach can fully benefit from DX API v2 (applications built on Theme Cosmos or Cosmos React).

The following list outlines the key features of both versions which help you decide which version to use:


  • Designed for a mashup-like use case.
  • Uses known and established UI rules (harnesses, sections, controls, actions).
  • As a comprehensive version, is available from release 8.3.2 onwards.
  • Supports React, Vue, and Angular starter packs available on Pega Marketplace.
  • Does not support all Pega UI capabilities out of the box.
  • Most suitable for existing applications.


  • Centered around App Studio and React-based view authoring instead of harnesses and sections (Theme Cosmos and Cosmos React applications).
  • Message structure clearly separates data and layout, which improves API binding and allows you to use such technologies as Redux more efficiently.
  • Reduces implementation effort for alternative UI stacks by using DX JavaScript APIs and starter kit structural components.
  • Introduces Hypermedia as the Engine of Application State (HATEOAS). As a result, responses provide references to available actions.
  • Reduces the number of messages (chattiness).
  • Introduces additional endpoints, for example, for following or unfollowing a case, or changing case stages.
  • Includes a prebuilt interpreter that is compatible with established frameworks, such as React, Vue, and Angular.
  • Aims to support the full Pega UI capability set and is part of current and future Cosmos implementations.
  • Most suitable for new applications.
Suggest Edit
Did you find this content helpful?

100% found this useful

Have a question? Get answers now.

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