Get inspired at ContentCon Europe. See the agenda and register for free.
Get inspired at ContentCon Europe. See the agenda and register for free.
Contentstack.comAcademyLogin
CS-log-dark.svgCS-log-dark.svg
  • Changelog
  • APIs
  • SDKs

Platform

  • Solution Center
  • Marketplace
  • Changelog
  • Developers & IT
  • Business users
  • Digital leaders
  • Developer Fast Track
  • Plans & Pricing

Solutions

  • Retail
  • Travel and tourism
  • Financial services
  • Technology
  • Manufacturing
  • E-commerce
  • Localization
  • Personalization
  • Portals and knowledge bases

Resources

  • Academy
  • Docs
  • Product updates
  • Contentstack on Contentstack
  • Blog
  • Insights and analyst reports
  • Webinars
  • Podcasts
  • Glossary
  • Content generative library
  • Community
  • Headless CMS
  • Composable AXP
  • Personalization
  • CDP

Customers

  • Case Studies
  • Customer Care
  • Contentstack Experience Awards
  • Customer support

Partners

  • Overview
  • Find a partner
  • Login

Company

  • About us
  • News
  • Customer support portal
  • Contact

Social

  • Facebook
  • LinkedIn
  • Instagram
  • GitHub
  • YouTube
  • Discord
  • X
LegalTermsPrivacyTrust Center

Cookie settings

Copyright © 2026 Contentstack Inc. All rights reserved.
/
  1. Home
  2. APIs
  3. Personalize Management API
  4. Experiences Priority

Experiences Priority

markdownView as Markdown

Experiences Priority helps you define the degree of importance for each experience in your project. If mulitple experiences customize the same section of your digital property, it needs to be decided which experience's personalized content is to be ultimately presented. The priority order can be used to make this decision. It contains the UIDs of each experience in the project, in decreasing order of priority. The following requests allow you to manage the priority order of the experiences within a project.

Get Experiences Priority

GEThttps://personalize-api.contentstack.com/experiences-priority

The Get Experiences Priority request retrieves the experience priority order for a given project. This contains every experience available within the project sorted in decreasing order of priority.

To configure the permissions for your application via OAuth, include the personalize:read or personalize:manage scope.

Sample Response
Status|200 OK
1234567891011121314
{
  "priorityOrder": [
    "66d5ad0000000001412ae841",
    "66d5ad0000000001412ae842",
    "66d5ad0000000001412ae843"
  ],
  "project": "6887777b3335554698867847",
  "createdBy": "bxxxxxxxxxxxx3",
  "updatedBy": "bxxxxxxxxxxxx6",
  "createdAt": "2024-03-13T15:39:51.645Z",
  "updatedAt": "2024-03-13T15:39:51.645Z",
  "createdByUserName": "Jane Doe",
  "updatedByUserName": "Jane Doe"
}

Update Experiences Priority

PUThttps://personalize-api.contentstack.com/experiences-priority

The Update Experiences Priority request lets you rearrange experiences in the priority order at any given time. For example, if you create a new experience that should have a higher priority than others, the priority order can be updated after creating the new experience.

To configure the permissions for your application via OAuth, include the personalize:manage scope.

Sample Request
1234567
{
  "priorityOrder": [
    "66d5ad0000000001412ae841",
    "66d5ad0000000001412ae842",
    "66d5ad0000000001412ae843"
  ]
}
Sample Response
Status|200 OK
1234567891011121314
{
  "priorityOrder": [
    "66d5ad0000000001412ae841",
    "66d5ad0000000001412ae842",
    "66d5ad0000000001412ae843"
  ],
  "project": "6887777b3335554698867847",
  "createdBy": "bxxxxxxxxxxxx3",
  "updatedBy": "bxxxxxxxxxxxx6",
  "createdAt": "2024-03-13T15:39:51.645Z",
  "updatedAt": "2024-03-13T15:39:51.645Z",
  "createdByUserName": "Jane Doe",
  "updatedByUserName": "Jane Doe"
}
Hide Parameters

Headers

authorizationoptionalstring

Enter your OAuth token here. Read more: https://www.contentstack.com/docs/developers/developer-hub/contentstack-oauth

authtokenoptionalstring

Enter your authtoken here. Read more: https://www.contentstack.com/docs/developers/create-tokens/types-of-tokens#authentication-tokens-authtokens

x-project-uidrequiredstring

Hide Parameters

Headers

authorizationoptionalstring

Enter your OAuth token here. Read more: https://www.contentstack.com/docs/developers/developer-hub/contentstack-oauth

authtokenoptionalstring

Enter your authtoken here. Read more: https://www.contentstack.com/docs/developers/create-tokens/types-of-tokens#authentication-tokens-authtokens

x-project-uidrequiredstring