Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Workday Business Processes Approvals API

Manage approval steps and approval chains

Workday Business Processes Approvals API is one of 4 APIs that Workday Business Processes publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 14 JSON Schema definitions.

Tagged areas include Approvals. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, rate-limit docs, a changelog, a support channel, and 14 JSON Schemas.

This API exposes 2 operations across 2 paths, and defines 4 schemas. It is described by OpenAPI 3.0.3, at version v41.1.

Requests are made against a single base URL, https://{tenant}.workday.com/api/businessProcess/v1.

2 operations 2 paths 4 schemas 2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
v41.1
Base URL
https://wd2-impl-services1.workday.com/ccx/service
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Workday Business Processes Approvals API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the clientCredentials flow, exposing 1 scope. By default, every request must be authenticated.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 POST. Each is listed below with its method, path, parameters, and response codes.

Approvals 2

Manage approval steps and approval chains

POST
/inboxItems/{itemId}/approve
Workday Approve Inbox Item
approveInboxItem 1 param body → 200400401403404
POST
/inboxItems/{itemId}/deny
Workday Deny Inbox Item
denyInboxItem 1 param body → 200400401403404

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are InboxItem (10 properties), ErrorResponse (3 properties), ApprovalRequest (2 properties), DenialRequest (2 properties). Each schema is shown below with its type and property counts.

DenialRequest
object
Request to deny an inbox item
2 properties 2 required
ErrorResponse
object
Standard error response
3 properties 2 required
InboxItem
object
A business process inbox item requiring user action
10 properties 5 required
ApprovalRequest
object
Request to approve an inbox item
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

workday-business-processes-approvals-api-openapi.yml Raw ↑

Other APIs Workday Business Processes publishes across the network.

Workday Business Processes Business Process Definitions API
Workday Business Processes Inbox Items API
Workday Business Processes Process Instances API