Governance Delegates - 500 Error when calling the PATCH API
Apr 15, 2026
Identity Governance
Overview
When there are no delegates OrgSetting, calling PATCH /governance/api/v1/principal-settings/{targetPrincipalId} results in the following error:
NullPointerException
Applies To
- Okta Identity Governance (OIG)
- Governance Delegates
Cause
Customers who:
-
are calling the PATCH principal-settings API without the MANAGED_ORG_SETTING or Super Admin permission (only have AC Admin + AR admin roles)
-
have not toggled the "User-assigned delegates" settings before
will see a 500 on PATCH /governance/api/v1/principal-settings/{targetPrincipalId}
Solution
Current Workaround:
- Access the Okta Admin Console.
- Navigate to Identity Governance > Settings > Delegates tab.
- Toggle the "Enable end users to assign their own delegate" setting on, then immediately off again
