Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Changelog for businessProcess 03/18/2026 API
description: The public APIs to access event actions and details
version: v1
servers:
- url: https://<tenantHostname>/businessProcess/v1
tags:
- name: 03/18/2026
description: Changes for v2026.11
paths:
2026.11/eventSteps/{ID}/reassign:
post:
tags:
- 03/18/2026
summary: Added new operation
description: 'Reassigns the business process event step specified by the reference ID of the originating event step.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
View this Endpoint: POST /eventSteps/{ID}/reassign'
parameters:
- name: ID
in: path
description: The Workday ID of the resource.
required: true
style: SIMPLE
explode: false
schema:
type: string
exampleSetFlag: false
types:
- string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/businessProcessStepsReassign_bd578ca9ac8010001895bda38db00000'
exampleSetFlag: false
exampleSetFlag: false
responses:
'201':
description: Resource created.
content:
application/json:
schema:
$ref: '#/components/schemas/businessProcessStepsReassign_bd578ca9ac8010001895bda38db00000'
exampleSetFlag: false
exampleSetFlag: false
'400':
description: 'Invalid request. (https://community.workday.com/rest/error-messages)
Error Code | Validation Message
--- | ---
A2822 | Specify a comment.
A3055 | You can''t remove and add the same person to the business process step. Specify a different person for the reassignment.
A3056 | Specify at least 1 person to remove or 1 person to add to the business process step.
A3057 | Specify a valid person to remove from the business process step. You can''t remove a person that''s not a current awaiting person for the step.
A3058 | There must be at least 1 awaiting person.
A3059 | Specify a valid person. You can''t reassign the business process step to the current awaiting person.
A3152 | You don''t have security permissions to perform this reassignment.
A3153 | You can''t reassign the event because the event record has a Completed status.
A3154 | You can''t reassign the event.
A3173 | The role you''re attempting to reassign to is blocked by routing restrictions.
A3174 | You can''t assign the business process step to a person that doesn''t have an active Workday account.
A3175 | Specify a valid role to reassign the business process step to. The person''s role isn''t configured or isn''t part of a security group on the business process security policy to perform the action.
A3185 | Specify a valid step type. Reassignment doesn''t support this step type.
A3186 | You can''t reassign this business process step.
A3187 | You can’t reassign the event because eSignature isn’t supported in reassignment.'
content: {}
'401':
description: 'Unauthorized: Missing or invalid credentials. (https://community.workday.com/rest/error-messages)'
content:
application/json:
schema:
$ref: '#/components/schemas/VALIDATION_ERROR_MODEL_REFERENCE'
exampleSetFlag: false
exampleSetFlag: false
'403':
description: User has insufficient permissions. (https://community.workday.com/rest/error-messages)
content:
application/json:
schema:
$ref: '#/components/schemas/VALIDATION_ERROR_MODEL_REFERENCE'
exampleSetFlag: false
exampleSetFlag: false
'404':
description: Resource not found. (https://community.workday.com/rest/error-messages)
content:
application/json:
schema:
$ref: '#/components/schemas/VALIDATION_ERROR_MODEL_REFERENCE'
exampleSetFlag: false
exampleSetFlag: false
default:
description: An error occurred.
content:
application/json:
schema:
$ref: '#/components/schemas/ERROR_MODEL_REFERENCE'
exampleSetFlag: false
exampleSetFlag: false
extensions:
x-workday-confidence-level: Production
x-workday-internal-try-enabled: 'false'
operationId: post202611EventStepsByIDReassign
x-operation-id-source: derived
2026.11/types/{ID}/attachmentCategories:
get:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Retrieves all attachment categories for the specified business process type that the processing user can select for the specified event. You can filter by event target.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Retrieves all attachment categories for the specified business process type that the processing user can select for the specified event. You can filter by event target.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: GET /types/{ID}/attachmentCategories'
operationId: get202611TypesByIDAttachmentCategories
x-operation-id-source: derived
2026.11/events/{ID}/rescind:
post:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Rescinds the business process event specified by the ID. In the request body, specify these required fields: comment.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Rescinds the business process event specified by the ID. In the request body, specify these required fields: comment.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: POST /events/{ID}/rescind'
operationId: post202611EventsByIDRescind
x-operation-id-source: derived
2026.11/events/{ID}/cancel:
post:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Cancels the business process event specified by the ID. In the request body, specify these required fields: comment.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Cancels the business process event specified by the ID. In the request body, specify these required fields: comment.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: POST /events/{ID}/cancel'
operationId: post202611EventsByIDCancel
x-operation-id-source: derived
2026.11/eventSteps/{ID}/deny:
post:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Denies the business process event step specified by the ID of the originating event step. The processing person must have view access to the event. In the request body, specify these required fields: id (the event step you are denying), stepAction{id} (if there are multiple event steps), comment.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Denies the business process event step specified by the ID of the originating event step. The processing person must have view access to the event. In the request body, specify these required fields: id (the event step you are denying), stepAction{id} (if there are multiple event steps), comment.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: POST /eventSteps/{ID}/deny'
operationId: post202611EventStepsByIDDeny
x-operation-id-source: derived
2026.11/eventSteps/{ID}/toDo:
post:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Post an action for a To Do step in a business process.
Specify these required fields in the request body: {stepAction}.
You can add an optional comment, if enabled at tenant or business process level.
Valid values for stepAction are:
{ "id": "133d5c88baa64136aab041c1d2e9ed53" } for Submit,
{ "id": "d9e41d34446c11de98360015c5e6daf6" } for Save for Later.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Post an action for a To Do step in a business process.
Specify these required fields in the request body: {stepAction}.
You can add an optional comment, if enabled at tenant or business process level.
Valid values for stepAction are:
{ "id": "133d5c88baa64136aab041c1d2e9ed53" } for Submit,
{ "id": "d9e41d34446c11de98360015c5e6daf6" } for Save for Later.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: POST /eventSteps/{ID}/toDo'
operationId: post202611EventStepsByIDToDo
x-operation-id-source: derived
2026.11/eventSteps/{ID}/sendBack:
post:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Sends back the business process event step specified by the ID of the originating event step. In the request body, specify these required fields: id (the event step you are sending back), reason.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Sends back the business process event step specified by the ID of the originating event step. In the request body, specify these required fields: id (the event step you are sending back), reason.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: POST /eventSteps/{ID}/sendBack'
operationId: post202611EventStepsByIDSendBack
x-operation-id-source: derived
2026.11/eventSteps/{ID}/approve:
post:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Approves the business process event step specified by the ID of the originating event step. In the request body, specify these required fields: id (the event step you are approving), comment.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Approves the business process event step specified by the ID of the originating event step. In the request body, specify these required fields: id (the event step you are approving), comment.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: POST /eventSteps/{ID}/approve'
operationId: post202611EventStepsByIDApprove
x-operation-id-source: derived
2026.11/events:
get:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Retrieves a collection of business process events based on the specified parameters. You must specify exactly one worker parameter. If a worker parameter is not specified, returns a blank response.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Retrieves a collection of business process events based on the specified parameters. You must specify exactly one worker parameter. If a worker parameter is not specified, returns a blank response.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: GET /events'
operationId: get202611Events
x-operation-id-source: derived
2026.11/events/{ID}/remainingSteps:
get:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Retrieves all remaining business process steps for the specified business process event.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Retrieves all remaining business process steps for the specified business process event.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: GET /events/{ID}/remainingSteps'
operationId: get202611EventsByIDRemainingSteps
x-operation-id-source: derived
2026.11/events/{ID}/comments:
get:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Retrieves comments on the specified business process event.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Retrieves comments on the specified business process event.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: GET /events/{ID}/comments'
operationId: get202611EventsByIDComments
x-operation-id-source: derived
2026.11/events/{ID}:
get:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Retrieves the business process event with the specified ID.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Retrieves the business process event with the specified ID.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: GET /events/{ID}'
operationId: get202611EventsByID
x-operation-id-source: derived
2026.11/events/{ID}/inProgressSteps:
get:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Retrieves all business process steps that are currently in progress for the specified business process event.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Retrieves all business process steps that are currently in progress for the specified business process event.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: GET /events/{ID}/inProgressSteps'
operationId: get202611EventsByIDInProgressSteps
x-operation-id-source: derived
2026.11/events/{ID}/attachments:
get:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Retrieves attachments on the specified business process event that the processing user has permission to view.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Retrieves attachments on the specified business process event that the processing user has permission to view.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: GET /events/{ID}/attachments'
operationId: get202611EventsByIDAttachments
x-operation-id-source: derived
2026.11/eventSteps:
get:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Retrieves a collection of business process event steps. You can filter the event steps by business process, creation date, due date, and step type.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Retrieves a collection of business process event steps. You can filter the event steps by business process, creation date, due date, and step type.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: GET /eventSteps'
operationId: get202611EventSteps
x-operation-id-source: derived
2026.11/eventSteps/{ID}:
get:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Returns a business process event step. Returned results are secured based on processing person''s view access to the event to which the step belongs. If the processing person does not have view access to the event, when this API is called, they will not be able to retrieve the event step and receive a 404 error.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Returns a business process event step. Returned results are secured based on processing person''s view access to the event to which the step belongs. If the processing person does not have view access to the event, when this API is called, they will not be able to retrieve the event step and receive a 404 error.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: GET /eventSteps/{ID}'
operationId: get202611EventStepsByID
x-operation-id-source: derived
2026.11/events/{ID}/completedSteps:
get:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Retrieves all business process steps that are completed for the specified buinesss process event.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Retrieves all business process steps that are completed for the specified buinesss process event.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: GET /events/{ID}/completedSteps'
operationId: get202611EventsByIDCompletedSteps
x-operation-id-source: derived
2026.11/eventSteps/{ID}/questionnaire:
post:
tags:
- 03/18/2026
summary: Description has been changed
description: '## Description changed
|
Updated Value
|
Previous Value
|
| :--- | :--- |
|
Post an action for a Complete Questionnaire step in a business process.
Specify these required fields in the request body if the intended action is Submit or Save for Later: {stepAction, questionnaireResponse}.
You can send Save for Later multiple times, but {questionnaireResponse} values will replace the existing questionnaire answers.
If the intended action is Skip, exclude {questionnaireResponse} from the request body.
Valid values for stepAction are:
{ "id": "133d5c88baa64136aab041c1d2e9ed53" } for Submit,
{ "id": "d9e41a8c446c11de98360015c5e6daf6" } for Save for Later,
{ "id": "d9e4231a446c11de98360015c5e6daf6" } for Skip.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Benefits, Tenant Non-Configurable
|
Post an action for a Complete Questionnaire step in a business process.
Specify these required fields in the request body if the intended action is Submit or Save for Later: {stepAction, questionnaireResponse}.
You can send Save for Later multiple times, but {questionnaireResponse} values will replace the existing questionnaire answers.
If the intended action is Skip, exclude {questionnaireResponse} from the request body.
Valid values for stepAction are:
{ "id": "133d5c88baa64136aab041c1d2e9ed53" } for Submit,
{ "id": "d9e41a8c446c11de98360015c5e6daf6" } for Save for Later,
{ "id": "d9e4231a446c11de98360015c5e6daf6" } for Skip.
Secured by: Core Navigation, Public Business Processes
Scope: Adaptive Planning for Financial Plans, Adaptive Planning for the Workforce, Tenant Non-Configurable
|
View this Endpoint: POST /eventSteps/{ID}/questionnaire'
operationId: post202611EventStepsByIDQuestionnaire
x-operation-id-source: derived
components:
schemas:
removeAssignees_d6a10186b85d10001786ad45b71c0000:
exampleSetFlag: false
allOf:
- $ref: '#/components/schemas/roles_d6a10186b85d1000177ee6105ff50000'
exampleSetFlag: false
- type: object
properties:
id:
type: string
description: The id for Role Representation
exampleSetFlag: false
types:
- string
exampleSetFlag: false
types:
- object
awaitingRoles_d6a10186b85d100015f2f7094b410000:
exampleSetFlag: false
allOf:
- $ref: '#/components/schemas/roles_d6a10186b85d1000177ee6105ff50000'
exampleSetFlag: false
- type: object
properties:
id:
type: string
description: The id for Role
exampleSetFlag: false
types:
- string
exampleSetFlag: false
types:
- object
ERROR_MODEL_REFERENCE:
required:
- error
type: object
properties:
error:
type: string
description: A description of the error
exampleSetFlag: false
types:
- string
code:
type: string
description: The code that corresponds to the error message. Use the error code to drive programmatic error-handling behavior. Don't use error message strings for this purpose because they are subject to change
exampleSetFlag: false
types:
- string
field:
type: string
description: The field related to the error
exampleSetFlag: false
types:
- string
path:
type: string
description: The path of the field related to the error
exampleSetFlag: false
types:
- string
severity:
type: string
description: Severity of the validation (e.g. Critical, Warning).
exampleSetFlag: false
types:
- string
internalMessage:
type: string
description: Internal message providing additional context for the validation (e.g. representation content validation details).
exampleSetFlag: false
types:
- string
exampleSetFlag: false
types:
- object
addAssignees_d6a10186b85d10001820dee2dce40000:
exampleSetFlag: false
allOf:
- $ref: '#/components/schemas/roles_d6a10186b85d1000177ee6105ff50000'
exampleSetFlag: false
- type: object
properties:
id:
type: string
description: The id for Role Representation
exampleSetFlag: false
types:
- string
exampleSetFlag: false
types:
- object
VALIDATION_ERROR_MODEL_REFERENCE:
exampleSetFlag: false
allOf:
- required:
- error
type: object
properties:
error:
type: string
description: A description of the error
exampleSetFlag: false
types:
- string
errors:
type: array
description: An array of validation errors
exampleSetFlag: false
items:
$ref: '#/components/schemas/ERROR_MODEL_REFERENCE'
exampleSetFlag: false
types:
- array
exampleSetFlag: false
types:
- object
roles_d6a10186b85d1000177ee6105ff50000:
exampleSetFlag: false
allOf:
- type: object
properties:
descriptor:
type: string
description: The display name of the instance
example: Lorem ipsum dolor sit ame
exampleSetFlag: true
types:
- string
id:
type: string
description: The id for Role Representation
exampleSetFlag: false
types:
- string
exampleSetFlag: false
types:
- object
businessProcessStepsReassign_bd578ca9ac8010001895bda38db00000:
exampleSetFlag: false
allOf:
- type: object
properties:
awaitingRoles:
type: array
description: The roles that the business event step is awaiting.
extensions:
x-workday-type: Multi-instance
x-readOnly: true
exampleSetFlag: false
items:
$ref: '#/components/schemas/awaitingRoles_d6a10186b85d100015f2f7094b410000'
exampleSetFlag: false
types:
- array
addAssignees:
type: array
description: Assignees added to the business process step because of reassignment.
extensions:
x-workday-type: Multi-instance
exampleSetFlag: false
items:
$ref: '#/components/schemas/addAssignees_d6a10186b85d10001820dee2dce40000'
exampleSetFlag: false
types:
- array
removeAssignees:
type: array
description: Assignees removed from the business process step because of reassignment.
extensions:
x-workday-type: Multi-instance
exampleSetFlag: false
items:
$ref: '#/components/schemas/removeAssignees_d6a10186b85d10001786ad45b71c0000'
exampleSetFlag: false
types:
- array
comment:
type: string
description: Comments provided on the business process step because of reassignment.
example: Lorem ipsum dolor sit amet, cum choro singulis consectetuer ut, ubique iisque contentiones ex duo. Quo lorem etiam eu.
extensions:
x-workday-type: Text
exampleSetFlag: true
types:
- string
descriptor:
type: string
description: The display name of the instance
example: Lorem ipsum dolor sit ame
exampleSetFlag: true
types:
- string
id:
type: string
description: The id for Event Record
exampleSetFlag: false
types:
- string
exampleSetFlag: false
types:
- object
securitySchemes:
OAuth2:
type: OAUTH2
flows:
implicit:
authorizationUrl: https://<tenantAuthorizationHostname>
scopes: {}