---
title: "Update Priority Scores for Purpose Statuses"
method: PUT
path: "/api/consent/v2/consent-groups/settings"
tags: ["Consent Groups"]
---

# Update Priority Scores for Purpose Statuses

`PUT /api/consent/v2/consent-groups/settings`

Use this API to update the current Priority Score values for the Purpose Statuses. Priority Scores across the entire Consent Group hierarchy are used to calculate the Effective Status of a Purpose.

> 🗒 Things to Know
> 
> - All Purpose Statuses are given a Priority Score. A Purpose Status with a lower Priority Score will be given precedence over a Purpose Status with a higher Priority Score. Any new Purpose Statuses will automatically be given a higher priority score by default.
> - When calculating the Effective Status of any Purpose in a Consent Group:
> - If there is no Parent Consent Group, the Effective Status becomes the same as the Enforced Status.
> - If there is a Parent Consent Group, the Effective Status would be calculated by comparing the Priority Score of the Enforced Status of the Purpose at that hierarchy level with the Priority Score of the Effective Status of the Purpose in the Parent level and applying the status associated with the lower Priority Score.

> 👍 
> 
> For more information, see [Using Consent Groups to Alter a Data Subject's Consent Status](https://developer.onetrust.com/onetrust/docs/using-consent-groups-to-alter-a-data-subjects-consent-status).

## Request body

- ConsentAPIConsentGroupSettingsDto
  - `statusPriorityRules` ConsentAPIConsentGroupStatusPriorityDto[], required — The Priority of the Purpose Statuses in the context of Consent Groups
    - `status` 'ACTIVE' | 'ALWAYS' | 'ACTIVE' | 'OPT OUT' | 'HARD OPT OUT' | 'PENDING' | 'NO CONSENT' | 'WITHDRAWN' | 'EXPIRED' — The Purpose Status value
    - `priority` integer, required — The Priority of the Purpose Status, with 0 being the highest possible value

## Response `200`

Successfully updated Consent Group settings.

- ConsentAPIConsentGroupSettingsDto
  - `statusPriorityRules` ConsentAPIConsentGroupStatusPriorityDto[], required — The Priority of the Purpose Statuses in the context of Consent Groups
    - `status` 'ACTIVE' | 'ALWAYS' | 'ACTIVE' | 'OPT OUT' | 'HARD OPT OUT' | 'PENDING' | 'NO CONSENT' | 'WITHDRAWN' | 'EXPIRED' — The Purpose Status value
    - `priority` integer, required — The Priority of the Purpose Status, with 0 being the highest possible value

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500` — Internal Server Error

---

[API](https://skmtc.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)