Purview REST API Support for Unified Catalog - remove / update default "Purpose" drop-down values

Question

Purview REST API Support for Unified Catalog - remove / update default "Purpose" drop-down values

Thomas, Anna (External) 40

We want to update or better remove the 3 default drop down values in the purpose field when we select Request Access to a data product from the Unified Catalog. See image below.

The issue we are running into ie when using the Purview REST API, we are getting an internal 500 error when calling the policy set endpoint.

Looking forward to suggestions.

User's image

Kalyani Kondavaradala 405 Reputation points Microsoft External Staff Moderator

2025-08-01T13:42:35.4266667+00:00
Hi Thomas, Anna (External),

Thanks for reaching out on Microsoft Q&A!

Just to clarify, the default "Purpose" dropdown values in the Request Access form within the Unified Data Catalog are managed internally as part of data product access policies. At present, the supported method to customize or modify these values is through the Purview Studio interface.

Unfortunately, modifying these settings via the Purview REST API is not supported, and attempts to do so may result in errors (such as HTTP 500 responses), as the service does not expect external updates to this configuration.

Supported Method: Purview Studio

To update or remove the default "Purpose" options:

Sign in to Purview Studio

Go to data product >Access tab

Select the Access request settings tab

Under Purpose options, click Edit

Remove, rename, or add entries as needed

Click Save

Please ensure that you have proper roles or permissions to manage access request settings (like editing Purpose options), you should have the following roles

Purview Administrator- Full access to manage data governance settings, including Unified Catalog features

Collection Administrator-Can manage access control and settings within assigned collections

and Policy Author, Data Product Owner, or Data Curator on that product.

Please refer the Microsoft document for more details

https://learn.microsoft.com/en-us/purview/unified-catalog-data-product-access-requests

Hope this helps. Let me know if you have any further questions or need additional assistance, if you are still facing issues, please more details on error message it would be helpful to deeper dive into this issue.

Also, if these answers your query, do click the "Upvote" and click "Accept the answer" of which might be beneficial to other community members reading this thread.

Thanks,

Kalyani
Kalyani Kondavaradala 405 Reputation points Microsoft External Staff Moderator

2025-08-04T06:30:02.2033333+00:00

Hi Thomas, Anna (External),

Greetings for the day!

Just checking to see if you have a chance to check my previous response and helped, do let me know if you have any further questions on this.

If the provided information answers your query, do click "Upvote" and "Accept Answer", it will help others who might be facing similar challenges.

Thanks

Kalyani
Budge, Sony (External) 0 Reputation points

2025-08-04T14:53:24.8133333+00:00

Hi Kalyani,

I have collection and purview admin roles, but I am not able to find Access Control in the purview studio. Could you please help me to locate it.
Kalyani Kondavaradala 405 Reputation points Microsoft External Staff Moderator

2025-08-06T10:33:19.3066667+00:00

Hello Budge, Sony (External),

Thanks for your response!

could you please confirm are you also facing same issue? Sorry for confusion its a typo, i meant to say go to data product if you will be able to see the Access tab and then Access request settings then edit the purpose field dropdown values. You must be a Policy Author, Data Product Owner, or Data Curator on that product.

Ensure your role is assigned at the root collection level (not just a child collection).

This capability may not yet be available in some regions or tenants. Try refreshing the UI or using a different browser.

Please refer Microsoft documents for more details

https://learn.microsoft.com/en-us/purview/whats-new

https://learn.microsoft.com/en-us/purview/unified-catalog-data-product-access-requests

Thanks

Kalyani
Kalyani Kondavaradala 405 Reputation points Microsoft External Staff Moderator

2025-08-07T06:15:31.0533333+00:00

Hi Thomas, Anna (External),

We noticed we haven't received a response from you regarding the last update. If you've found a resolution, we’d greatly appreciate it if you could share it with the community, as it might benefit others. If not, please let us know, and we’ll provide further details and do our best to assist you.

Thanks,

Kalyani
Thomas, Anna (External) 40 Reputation points

2025-08-07T08:35:54.42+00:00

Hi @Kalyani Kondavaradala

My team member Sony followed your suggestion but was still not successful.

We are able to add new Purposes by following your instructions but the question we need answered is HOW TO REMOVE THE 3 DEFAULT PURPOSE VALUES. So no the answer provided does not solve the problem, it is still outstanding.
Kalyani Kondavaradala 405 Reputation points Microsoft External Staff Moderator

2025-08-07T13:49:02.19+00:00
Hi Thomas, Anna (External),

I understand that you are able to add new 'Purpose' dropdown values but not able remove the default ones like 'Assessing Fit' and 'Critical Reporting'.

Can you please confirm below questions:

were you able to delete other dropdown values except those three values?

Which interface are you using? Are you managing the data product via Purview Studio (Governance portal) or https://sip.purview.microsoft.com/

What type of policies are you using? Are you using custom policies you defined, or are you relying on the default Microsoft-generated policies?

Thanks

Kalyani
Thomas, Anna (External) 40 Reputation points

2025-08-07T14:44:08.8066667+00:00
Hello @Kalyani Kondavaradala

Here are the answers in italic:

were you able to delete other dropdown values except those three values? The other drop down values were added by us, so yes we are able to delete and/or modify those.

Which interface are you using? Are you managing the data product via Purview Studio (Governance portal) or https://sip.purview.microsoft.com/ We are using the latest Governance Portal.

What type of policies are you using? Are you using custom policies you defined, or are you relying on the default Microsoft-generated policies? We are using the default MSFT-generated policies.

Regards

Anna

Accepted answer

0 additional answers

Your answer

Kalyani Kondavaradala 405 Reputation points Microsoft External Staff Moderator

2025-08-01T13:42:35.4266667+00:00

Hi Thomas, Anna (External),

Thanks for reaching out on Microsoft Q&A!

Just to clarify, the default "Purpose" dropdown values in the Request Access form within the Unified Data Catalog are managed internally as part of data product access policies. At present, the supported method to customize or modify these values is through the Purview Studio interface.

Unfortunately, modifying these settings via the Purview REST API is not supported, and attempts to do so may result in errors (such as HTTP 500 responses), as the service does not expect external updates to this configuration.

Supported Method: Purview Studio

To update or remove the default "Purpose" options:

Sign in to Purview Studio

Go to data product >Access tab

Select the Access request settings tab

Under Purpose options, click Edit

Remove, rename, or add entries as needed

Click Save

Please ensure that you have proper roles or permissions to manage access request settings (like editing Purpose options), you should have the following roles

Purview Administrator- Full access to manage data governance settings, including Unified Catalog features

Collection Administrator-Can manage access control and settings within assigned collections

and Policy Author, Data Product Owner, or Data Curator on that product.

Please refer the Microsoft document for more details

https://learn.microsoft.com/en-us/purview/unified-catalog-data-product-access-requests

Hope this helps. Let me know if you have any further questions or need additional assistance, if you are still facing issues, please more details on error message it would be helpful to deeper dive into this issue.

Also, if these answers your query, do click the "Upvote" and click "Accept the answer" of which might be beneficial to other community members reading this thread.

Thanks,

Kalyani
Kalyani Kondavaradala 405 Reputation points Microsoft External Staff Moderator

2025-08-04T06:30:02.2033333+00:00

Hi Thomas, Anna (External),

Greetings for the day!

Just checking to see if you have a chance to check my previous response and helped, do let me know if you have any further questions on this.

If the provided information answers your query, do click "Upvote" and "Accept Answer", it will help others who might be facing similar challenges.

Thanks

Kalyani
Budge, Sony (External) 0 Reputation points

2025-08-04T14:53:24.8133333+00:00

Hi Kalyani,

I have collection and purview admin roles, but I am not able to find Access Control in the purview studio. Could you please help me to locate it.
Kalyani Kondavaradala 405 Reputation points Microsoft External Staff Moderator

2025-08-06T10:33:19.3066667+00:00

Hello Budge, Sony (External),

Thanks for your response!

could you please confirm are you also facing same issue? Sorry for confusion its a typo, i meant to say go to data product if you will be able to see the Access tab and then Access request settings then edit the purpose field dropdown values. You must be a Policy Author, Data Product Owner, or Data Curator on that product.

Ensure your role is assigned at the root collection level (not just a child collection).

This capability may not yet be available in some regions or tenants. Try refreshing the UI or using a different browser.

Please refer Microsoft documents for more details

https://learn.microsoft.com/en-us/purview/whats-new

https://learn.microsoft.com/en-us/purview/unified-catalog-data-product-access-requests

Thanks

Kalyani
Kalyani Kondavaradala 405 Reputation points Microsoft External Staff Moderator

2025-08-07T06:15:31.0533333+00:00

Hi Thomas, Anna (External),

We noticed we haven't received a response from you regarding the last update. If you've found a resolution, we’d greatly appreciate it if you could share it with the community, as it might benefit others. If not, please let us know, and we’ll provide further details and do our best to assist you.

Thanks,

Kalyani
Thomas, Anna (External) 40 Reputation points

2025-08-07T08:35:54.42+00:00

Hi @Kalyani Kondavaradala

My team member Sony followed your suggestion but was still not successful.

We are able to add new Purposes by following your instructions but the question we need answered is HOW TO REMOVE THE 3 DEFAULT PURPOSE VALUES. So no the answer provided does not solve the problem, it is still outstanding.
Kalyani Kondavaradala 405 Reputation points Microsoft External Staff Moderator

2025-08-07T13:49:02.19+00:00

Hi Thomas, Anna (External),

I understand that you are able to add new 'Purpose' dropdown values but not able remove the default ones like 'Assessing Fit' and 'Critical Reporting'.

Can you please confirm below questions:

were you able to delete other dropdown values except those three values?

Which interface are you using? Are you managing the data product via Purview Studio (Governance portal) or https://sip.purview.microsoft.com/

What type of policies are you using? Are you using custom policies you defined, or are you relying on the default Microsoft-generated policies?

Thanks

Kalyani
Thomas, Anna (External) 40 Reputation points

2025-08-07T14:44:08.8066667+00:00

Hello @Kalyani Kondavaradala

Here are the answers in italic:

were you able to delete other dropdown values except those three values? The other drop down values were added by us, so yes we are able to delete and/or modify those.

Which interface are you using? Are you managing the data product via Purview Studio (Governance portal) or https://sip.purview.microsoft.com/ We are using the latest Governance Portal.

What type of policies are you using? Are you using custom policies you defined, or are you relying on the default Microsoft-generated policies? We are using the default MSFT-generated policies.

Regards

Anna

Answer 1

Hi @Thomas, Anna (External),

Thanks for your detailed information!

There are few system-defined values provisioned by Microsoft as part of the baseline policy framework in Microsoft Purview.

These entries are intentionally locked and cannot be removed or edited, even though the Governance Portal. This is by design to ensure alignment with Microsoft’s compliance and governance model across data products.

While you can freely add, modify, or delete any custom-defined Purpose values, the default ones remain non-editable to maintain consistency in access governance.

At this time, there is no supported method to remove or hide these system-defined Purpose values.

Create Custom Policy:

Please try to create your own custom access policies:

Go to Settings>Access Management>Access Policies

Create a new custom policy set to replace the Microsoft default

When configuring your custom policy, you can define your own purpose values

If this limitation is impacting your experience, I recommend submitting feedback through the Microsoft Purview Feedback Portal

Hopes this information helps you, if it is please upvote so that it will help other community members reading this thread.

Thanks,

Kalyani

Share via

Purview REST API Support for Unified Catalog - remove / update default "Purpose" drop-down values

0 additional answers

Your answer