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 Business Process Definitions API

Retrieve and manage business process type definitions

Workday Business Processes Business Process Definitions 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 Business Process Definitions. 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 GET

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 Business Process Definitions 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 GET. Each is listed below with its method, path, parameters, and response codes.

Business Process Definitions 2

Retrieve and manage business process type definitions

GET
/businessProcessDefinitions
Workday List Business Process Definitions
listBusinessProcessDefinitions 3 params → 200401403
GET
/businessProcessDefinitions/{definitionId}
Workday Get Business Process Definition
getBusinessProcessDefinition 1 param → 200401403404

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are BusinessProcessDefinition (7 properties), ProcessStepDefinition (5 properties), ErrorResponse (3 properties), BusinessProcessDefinitionsResponse (2 properties). Each schema is shown below with its type and property counts.

BusinessProcessDefinitionsResponse
object
Paginated response containing a list of business process definitions
2 properties 2 required
ErrorResponse
object
Standard error response
3 properties 2 required
BusinessProcessDefinition
object
A Workday business process type definition with steps and configuration
7 properties 4 required
ProcessStepDefinition
object
A step definition within a business process
5 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

workday-business-processes-business-process-definitions-api-openapi.yml Raw ↑

Other APIs Workday Business Processes publishes across the network.

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