Skip to main content
Users
CloudPortalLogin
  • Powered byPowered by
Developing with Sitecore CDP
Data privacy
Before you start sending data
Integrating with Sitecore CDP
Stream API
Batch API
REST APIs
Data lake export service
  • Sitecore CDP for developers
  • REST APIs
  • Legacy REST APIs
  • Guest REST API v2 (legacy)
  • Differences between v2 and v2.1 of the Guest and Guest data extension REST APIs

Differences between v2 and v2.1 of the Guest and Guest data extension REST APIs

If your instance of Sitecore CDP is using the 2.1 data model, we recommend that you upgrade to the Guest and Guest data extension REST APIs version 2.1.

Here's an overview of the main differences between version 2 and version 2.1:

v2

v2.1

URI paths

URI paths contain /v2/.

URI paths contain /v2.1/.

Endpoints for partial operations

  • Partial updates and partial deletions are not available.

  • Updates and deletions affect the entire resource. Because of this, you must use a different data extension name for each source system so that updates from one source system do not overwrite the data from a different source system.

  • New PATCH endpoints let you partially update guests and partially update data extensions. For example, you can update certain key-value pairs without affecting others.

  • A new DELETE endpoint lets you delete certain key-value pairs from a guest data extension without affecting others.

  • With partial operations, you no longer have to use a different data extension name for each source system, but we still recommend it as a best practice.

Endpoints for data extensions

Endpoints for data extensions use the less developer-friendly data extension reference.

More developer-friendly data extension endpoints let you specify the name of the data extension (see the possible values) in the request body when you create a data extension. You can then use that name in the URI of other endpoints to work with the data extension.

Do you have some feedback for us?

If you have suggestions for improving this article,

Privacy policySitecore Trust CenterCopyright © 1999-2025 Sitecore