Delegate appointments

Understand delegate appointment tool scopes, features, and capabilities, with sample workflows and example prompts.

Early Access release

Tool name

okta_identity_governance

Okta scopes

okta.governance.delegates.read, okta.governance.delegates.manage, and okta.governance.principalSettings.manage

What you can do

• List all delegate appointments in the org
• Filter delegate appointments by one or more specific delegator user IDs
• Paginate through delegate appointments using a cursor
• Update the governance settings for any target principal by appointing or replacing their delegate
• Revoke a target principal's current delegate by setting appointments to an empty array
• Add optional delegate appointment details such as a note, start time, and end time
• Restrict actions based on your granted OAuth scopes

Sample use cases

Use case	Prompt	Result
An admin needs to audit who's currently covering for managers while they're on leave, since HR flagged that approval coverage needs to be confirmed across several teams.	List all delegate appointments in the org so I can see who's currently covering for managers who are on leave.	All delegate appointments across the org are retrieved, showing each delegator, their assigned delegate, and the appointment's time window, so the admin can confirm coverage.
An employee is going on leave and hasn't set up their own delegate, so the admin needs to appoint one on their behalf to keep governance approvals moving.	Appoint Alice Johnson as the governance delegate for Bob Martin, with the note 'Acting delegate during leave of absence,' starting one week from now and ending one month from now.	Bob Martin's governance settings are updated with Alice Johnson appointed as his delegate, including the note and the specified time window.