---
title: "Workday Task Delegation Rules for External API Approvals"
description: "How Manage Delegations, Business Process Security Policy permissions, routing restrictions, and API inbox queries handle delegated Workday approvals and audits."
url: https://kiweely.com/guides/workday-delegation-rules-external-approvals-acting-on-behalf
---

# 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 November 15
-   Applies to **Workday Business Processes & Security**
-   7 min read
-   Published November 15
-   By Kiweely

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 |
| --- | --- | --- | --- | --- |
|  **My Tasks Delegation (Period)** | `Manage Delegations` -> **Do My Tasks On My Behalf** (*For all* or *specific* BPs) | Stays with delegator; completed **on behalf of** delegator. |  **No** (may request reassignment if allowed). | Appears to delegate (and to delegator **only if** `Retain Access` is checked). |
|  **Single Task Delegation (Ad Hoc)** | My Tasks item -> Related Actions -> **`Delegate Task`** | Stays with delegator; notifications state delegate acted on delegator’s behalf. |  **No**. | Removed from delegator’s My Tasks; routed to delegate for that 1 task only. |
|  **Business Process Initiation Delegation** | `Manage Delegations` -> **Start On My Behalf** | Delegate switches account context (`View My Delegation Assignments`) to initiate BP for delegator. |  **No** (Alternate Delegates also cannot initiate). | Governed by **Who Can Start** -> *Security Groups who can delegate this action* on BP Policy. |
|  **Task Reassignment** | `POST /eventSteps/{ID}/reassign` or **`Reassign Task`** ([guide](https://kiweely.com/guides/workday-reassign-awaiting-action)) | Transfers step assignment to new worker; no “on behalf of” relationship. | Yes (subject to standard policy). | Moves 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](https://kiweely.com/leaf) and AI assistants connected through [Kiweely Bridge](https://kiweely.com/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

-   [Enable Business Process Task Delegations](https://doc.workday.com/admin-guide/en-us/manage-workday/business-processes/delegate-business-processes/business-process-task-delegation/enable-business-process-task-delegations.html)
-   [Delegate My Tasks](https://doc.workday.com/admin-guide/en-us/manage-workday/business-processes/delegate-business-processes/business-process-task-delegation/dan1370796482940.html)
-   [Concept: Delegation Rules](https://doc.workday.com/admin-guide/en-us/manage-workday/business-processes/delegate-business-processes/concept-delegation-rules.html)
-   [Concept: Delegation Routing Restrictions](https://doc.workday.com/admin-guide/en-us/manage-workday/business-processes/delegate-business-processes/concept-delegation-routing-restrictions.html)
-   [Concept: Single Task Delegation](https://doc.workday.com/admin-guide/en-us/manage-workday/business-processes/delegate-business-processes/single-task-delegation/concept-single-task-delegation.html)

## Related guides

[All guides](https://kiweely.com/guides)

-   [### Querying Pending Workday My Tasks and Inbox Approvals via API and WQL Retrieve pending Workday My Tasks items for the signed-in worker via GET /common/v1/workers/{ID}/inboxTasks, or query awaiting approvals with WQL data sources such as businessProcessTransactionsAwaitingMyAction and businessProcessStepsAwaitingMe alongside businessProcess v1 REST calls.](https://kiweely.com/guides/workday-inbox-my-tasks-awaiting-action-rest-wql)
-   [### How Workday Audits Business Processes Initiated via REST or SOAP Web Services Workday records every web-service-initiated business process in the Full Process Record and View Audit Trail under the authenticated Workday account. Whether that audit trail shows a real employee or a shared system bot depends on whether the caller used user-delegated OAuth or an ISU.](https://kiweely.com/guides/workday-business-process-audit-trail-initiated-via-web-service)
-   [### Approving, Denying, and Sending Back Workday Business Process Steps via REST and SOAP APIs Advance pending Workday workflow steps via businessProcess v1 REST endpoints (/eventSteps/{ID}/approve, /deny, /sendBack, /toDo, /reassign) using the Event Record WID, or via Integrations SOAP operations (Approve\_Business\_Process, Deny\_Business\_Process, Send\_Back\_Business\_Process).](https://kiweely.com/guides/workday-business-process-approve-deny-rest-soap-api)

### More guides on Business processes and security

[All 27 guides](https://kiweely.com/guides#business-processes)

-   [Why Workday Says ‘This Task Is Not Available’ or ‘Waiting on Initiator’ on a Business Process Step](https://kiweely.com/guides/workday-business-process-this-task-is-not-available)
-   [Why Can’t a Security Group See a Workday Dashboard or Worklet After You Added Permission?](https://kiweely.com/guides/workday-worklet-dashboard-not-visible-security)
-   [What does rescinded mean in Workday? Rescind vs cancel vs correct, and when each applies](https://kiweely.com/guides/workday-business-process-rescind-cancel-correct)
-   [Workday custom validations and condition rules: block bad data with Critical or Warning severity](https://kiweely.com/guides/workday-custom-validations-condition-rules)
-   [Workday Role-Based, User-Based, Intersection, and Aggregation Security Groups](https://kiweely.com/guides/workday-role-based-user-based-intersection-security-groups)
-   [Workday Domain Security vs. Business Process Security Policies: Which Controls What](https://kiweely.com/guides/workday-domain-vs-business-process-security-policies)
-   [Workday Business Process Advanced Routing: Exclude Initiator, Prior Approvers, and Alternates](https://kiweely.com/guides/workday-business-process-routing-mutual-exclusion)
-   [Constrained vs unconstrained security groups in Workday: which workers can a member see?](https://kiweely.com/guides/workday-constrained-vs-unconstrained-security-groups)

### From the blog on Business processes and security

[All posts](https://kiweely.com/blog)

-   [Preparing Workday Domain and Business Process Security Policies for a SOX Audit in Hours, Not Weeks](https://kiweely.com/blog/auditing-workday-segregation-of-duties-before-sox-review)
-   [The Anatomy of a Production-Safe Workday Change: Propose, Approve, Execute One by One, Read Back](https://kiweely.com/blog/anatomy-of-a-production-safe-workday-change)
-   [Why Workday Condition Rules Pass in Sandbox and Fail in Production](https://kiweely.com/blog/why-workday-condition-rules-fail-in-production)

## Let Workday check the work.

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

[Start for free](https://kiweely.com/download) [See how it works](https://kiweely.com/vine/how-it-works)

## Get the next guide in your inbox.

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