---
title: "Experiences Priority"
description: "<p>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.</p>"
url: "https://www.contentstack.com/docs/developers/apis/personalize-management-api/experiences-priority"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-04-24"
---

# Experiences Priority

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

### Get Experiences Priority

**GET** `/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.

#### Headers

- **authorization** (optional)
  Enter your OAuth token here. Read more: https://www.contentstack.com/docs/developers/developer-hub/contentstack-oauth
- **authtoken** (optional)
  Enter your authtoken here. Read more: https://www.contentstack.com/docs/developers/create-tokens/types-of-tokens#authentication-tokens-authtokens
- **x-project-uid** (required)

#### Sample Response

```json
{
  "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

### Update Experiences Priority

**PUT** `/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.

#### Headers

- **authorization** (optional)
  Enter your OAuth token here. Read more: https://www.contentstack.com/docs/developers/developer-hub/contentstack-oauth
- **authtoken** (optional)
  Enter your authtoken here. Read more: https://www.contentstack.com/docs/developers/create-tokens/types-of-tokens#authentication-tokens-authtokens
- **x-project-uid** (required)

#### Sample Response

```json
{
  "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"
}
```