Skip to content
KiweelyKiweelyKiweely

How Workday Task Delegation Works When Managers Approve Through APIs

When managers delegate via Manage Delegations or Delegate Task, Workday routes eligible awaiting Event Records to the delegate’s inboxTasks and WQL queues, enforces Delegation Rules and Routing Restrictions, and records ‘On Behalf Of’ attribution in audit history.

  • Checked against Workday on
  • Applies to Workday Business Processes & Security
  • 7 min read
  • Published
  • By Kiweely
On this page

When a manager delegates approvals in Workday via Manage Delegations (date-bounded My Tasks delegation) or Delegate Task (ad-hoc Single Task Delegation), Workday automatically surfaces eligible awaiting Event Record steps to the delegate’s user-delegated REST and WQL queries, enforces the delegator’s permission ceiling alongside tenant Routing Restrictions, and records that the delegate completed the step on behalf of the delegator. External approval screens and AI assistants that authenticate each user via their own Workday OAuth 2.0 session inherit these delegation rules natively—provided they read the right queue fields and handle retain-access edge cases.

Teams building external approval portals often confuse Delegation, Reassignment, and Initiation Delegation, or wonder why a delegate receives 403 Forbidden on one workflow step while approving three others cleanly. Below is the exact mechanics of Workday delegation across tenant setup, security policies, REST/WQL reads, SOAP management, and audit logs.

Comparing Workday’s Three Delegation Mechanisms (Plus Reassignment)

Workday separates doing My Tasks items from starting a new business process and permanently transferring ownership:

Mechanism Workday Task / Config Prompt Ownership & Audit Trail Can Delegate Re-Delegate? API Queue Visibility
MechanismMy Tasks Delegation (Period) Workday Task / Config PromptManage Delegations -> Do My Tasks On My Behalf (For all or specific BPs) Ownership & Audit TrailStays with delegator; completed on behalf of delegator. Can Delegate Re-Delegate?No (may request reassignment if allowed). API Queue VisibilityAppears to delegate (and to delegator only if Retain Access is checked).
MechanismSingle Task Delegation (Ad Hoc) Workday Task / Config PromptMy Tasks item -> Related Actions -> Delegate Task Ownership & Audit TrailStays with delegator; notifications state delegate acted on delegator’s behalf. Can Delegate Re-Delegate?No. API Queue VisibilityRemoved from delegator’s My Tasks; routed to delegate for that 1 task only.
MechanismBusiness Process Initiation Delegation Workday Task / Config PromptManage Delegations -> Start On My Behalf Ownership & Audit TrailDelegate switches account context (View My Delegation Assignments) to initiate BP for delegator. Can Delegate Re-Delegate?No (Alternate Delegates also cannot initiate). API Queue VisibilityGoverned by Who Can Start -> Security Groups who can delegate this action on BP Policy.
MechanismTask Reassignment Workday Task / Config PromptPOST /eventSteps/{ID}/reassign or Reassign Task (guide) Ownership & Audit TrailTransfers step assignment to new worker; no “on behalf of” relationship. Can Delegate Re-Delegate?Yes (subject to standard policy). API Queue VisibilityMoves from removeAssignees to addAssignees on the Event Record.

Four Configuration Gates That Control Whether a Task Delegates

Before troubleshooting why a pending approval did not appear in a delegate’s API response, check Workday’s four evaluation gates in order:

1. Tenant-Level Rules (Edit Tenant Setup - Business Processes)

Secured by the Set Up: Tenant Setup - BP and Notifications domain in the System functional area:

  • Users Can Delegate Tasks To: Restricts who appears in the Delegate prompt—Anyone, Peers (same supervisory org only), Subordinates (drill-down supervisory hierarchy), or Superiors (management chain). Note that this setting applies when workers delegate their own tasks, not when authorized security groups delegate on behalf of others via Manage Delegation Settings.
  • Require End Dates: Enforces an explicit End Date on My Tasks delegations (does not apply to single-task delegation). Remember that Begin Date (12:00:01 AM) and End Date (11:59:59 PM) always evaluate in the delegator’s time zone—so a San Francisco delegator (PST) delegating for November 16 grants access to a Munich delegate (CET) from 09:00:01 AM Nov 16 through 08:59:59 AM Nov 17 CET.
  • Apply Routing Restrictions during Delegation: Controls segregation-of-duties checks on delegates (detailed below).

2. Business Process Security Policy (Business Process Policy > Edit)

Even if a manager selects For all Business Processes on Manage Delegations, Workday only delegates tasks for business processes whose security policy has Allow Business Process Delegation checked under Policy Restrictions. Additionally, if your tenant’s Request Delegation Change business process definition includes a Review or Approval step, a newly submitted delegation does not route tasks until that approval completes!

3. Condition-Based Delegation Rules

Administrators can create condition rules on a business process definition (for example, Expense Report Total <= 999 USD) and attach them in the Delegation Rule prompt on Manage Delegations. When a team member submits a $1,200 expense report, Workday evaluates the condition false, skips the delegate, and leaves the task with the original security group.

4. Apply Routing Restrictions during Delegation & Alternate Delegate

Many financial and staffing workflows configure step Routing Restrictions to exclude prior approvers (for example, preventing the person who approved Step b from also completing a parallel or downstream To Do / Audit step).

  • When Apply Routing Restrictions during Delegation is checked on Edit Tenant Setup - Business Processes and a delegate approves Step b1, Workday treats that delegate as a prior approver—removing their ability to act on parallel or subsequent restricted steps (b2).
  • When a routing restriction blocks the primary delegate, Workday automatically routes the task to the configured Alternate Delegate (which defaults to the delegate’s primary manager when Use Default Alternate is checked). If both the delegate and alternate delegate are excluded by routing restrictions, the task appears on the Business Process Tasks Not Delegated admin report.

How REST, WQL, and SOAP APIs Expose Delegated Tasks

Querying Delegated Tasks via WQL (businessProcessStepsAwaitingMe)

While GET /common/v1/workers/me/inboxTasks and GET /businessProcess/v1/eventSteps return actionable steps for the signed-in user, Workday’s WQL data source businessProcessStepsAwaitingMe (primary business object: Event Record) gives external UIs explicit delegation filter parameters and metadata fields:

  • Built-in Optional Boolean Parameters:
    • excludeDelegatedItemsToMe (Do Not Include Items Delegated to Me): Set true if a user wants to filter their view down to strictly their own direct responsibilities.
    • includeMyDelegatedItems (Include My Items Delegated to Others): Lets a delegating manager inspect pending items currently delegated out to peers or subordinates.
  • Delegation Fields on Event Record:
    • activeBusinessProcessDelegation (Active Business Process Delegation)
    • non_DelegatableStepTask (Non-Delegatable Step Task)
    • completedBy (Completed By), completedByDelegate (Completed by Delegate), and completedByAssignee (Completed By Assignee)
sql
SELECT
  eventRecord,
  businessProcessEventAlternateName,
  step,
  stepType,
  person,
  awaitingPersons,
  activeBusinessProcessDelegation,
  cf_DueDateOnEventRecord
FROM businessProcessStepsAwaitingMe(
  startDate = '2026-10-01',
  endDate = '2026-11-15',
  includeMyDelegatedItems = false,
  excludeDelegatedItemsToMe = false
)

To audit active delegations across an organization or a specific worker’s past Request Delegation Change history via WQL, query currentDelegationsByOrganization (primary BO: Delegation) or delegationHistory (primary BO: Business Process Delegation Event, requiring a worker prompt). Note one built-in Workday UI/API limitation documented on Expense Report Event: while acting on behalf of a delegator, a delegate cannot view the Business Process tab on the expense report itself to inspect downstream approval status, and a delegate is always bounded by the delegator’s own permission limits (for example, if the delegator lacks Send Back or Deny permission on the BP Security Policy, the delegate cannot execute /sendBack or /deny either).

Watch Out for Retain Access to Delegated Tasks within My Tasks

On Manage Delegations, Workday checks Retain Access to Delegated Tasks within My Tasks automatically whenever a user adds or edits a row for all or specific business processes:

  • If Checked: Both the delegator and the delegate can view and complete the step via REST /eventSteps/{ID}/approve. Whoever submits first transitions the Event Record out of Awaiting Action, and the other receives HTTP 400 code A212 if they click later.
  • If Unchecked (or Single Task Delegation): The delegator loses access to act on the delegated task while active. Notably, in Workday’s Integrations SOAP service, if a delegator attempts Deny_Business_Process on a delegated task they no longer hold access to, Workday throws Validation_Fault: This task has been delegated to another user and cannot be Denied.

Managing Delegations Programmatically via SOAP (Integrations WSDL)

Administrators automating leave-of-absence handoffs can read and update delegations via Get_Business_Process_Delegations and Put_Business_Process_Delegation in the Integrations SOAP web service (secured by Business Process Delegation / admin domains). Two SOAP validation rules to keep in mind:

  1. Terminated workers cannot be passed as Delegator_Reference (A terminated worker isn't a valid worker and can't be a delegator).
  2. You must choose either For all Business Processes or specific business processes—never both simultaneously—and to deactivate all current delegations for a worker, pass <wd:Stop_Current_Delegations>true</wd:Stop_Current_Delegations> rather than an empty list.

How Workday Records “On Behalf Of” in Audit History

When a delegate approves a step using their own user-delegated Workday OAuth 2.0 bearer token (POST /businessProcess/v1/eventSteps/{ID}/approve), you do not pass any custom “act_as” header—Workday resolves the active delegation link automatically on the Event Record:

  1. GET /businessProcess/v1/events/{ID}/completedSteps: Records the actual human who authenticated (completedByPerson), completedDate, status, and comments.
  2. Process History & Audit Reports (My Delegations, Event Process History, WQL): Populates completedBy alongside completedByDelegate, and outbound notifications explicitly note that Manager B approved on Manager A’s behalf.

Because external interfaces built on Kiweely Leaf and AI assistants connected through Kiweely Bridge (both coming next) execute every Workday API call under each signed-in worker’s own Register API Client OAuth token rather than an Integration System User, Workday’s delegation rules, $999 condition caps, routing restrictions, and “On Behalf Of” SOX audit attribution work identically outside the Workday browser as they do inside it.

Frequently asked questions

What is the difference between Workday Task Delegation and Task Reassignment?

Reassignment transfers ownership of the step to a new assignee (replacing or modifying the awaiting role assignment), whereas Delegation keeps task responsibility with the original delegator and lets the delegate act on the delegator's behalf within the delegator's access limits—recording both names in notifications and process history.

Why didn't a delegated Expense Report over $1,000 appear in the delegate's API queue?

If a Delegation Rule (a condition rule such as Expense Report Total <= 999 USD) is attached on Manage Delegations, or if Allow Business Process Delegation is unchecked on the Business Process Security Policy, Workday withholds that task from the delegate and routes it to the original security group.

How does time zone affect Begin Date and End Date on Manage Delegations?

Workday evaluates delegation Begin Date (12:00:01 AM) and End Date (11:59:59 PM) strictly in the delegator's time zone, not the delegate's local time zone.

Can a delegate re-delegate a delegated task to a third worker?

No. Workday allows delegates to request reassignment on delegated tasks when permitted by policy, but prevents delegates from delegating an already-delegated task to another worker.

Sources checked

Related guides

All guides

Let Workday check the work.

Kiweely writes WQL and builds orchestrations in your own tenant, and Workday, not Kiweely, says whether they passed.

Get the next guide in your inbox.

One email a month with new guides and one Extend tip. Nothing else.

We’ll email you once to confirm. Unsubscribe in one click from any issue.