Workday Business Processes

Workday Business Processes Event Task Definitions API

A collection of Event Task Definitions for custom business process defined in Workday.

Documentation GitHub OpenAPI

Operations 6

POST /eventTaskDefinitions Create event task definition #

GET /eventTaskDefinitions Get event task definition #

GET /eventTaskDefinitions/{id} View event task definition #

PUT /eventTaskDefinitions/{id} Update event task definition #

PATCH /eventTaskDefinitions/{id} Patch event task definition #

DELETE /eventTaskDefinitions/{id} Delete event task definition #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/workday-business-processes:workday-business-processes-event-task-definitions-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  description: The public APIs to create and manage custom business process configurations.
  version: v1
  title: Custom Business Process Config Event Task Definitions API
  x-api-evangelist-harvested: '2026-09-17'
  x-api-evangelist-source: https://developer.workday.com/bundles/rest-directory-ui/public/static/openApiFiles/customBusinessProcessConfig_v1_swagger.json
servers:
- url: https://api.workday.com/customBusinessProcessConfig/v1
tags:
- name: Event Task Definitions
  description: A collection of Event Task Definitions for custom business process defined in Workday.
paths:
  /eventTaskDefinitions:
    post:
      tags:
      - Event Task Definitions
      description: Creates a new event task definition.
      operationId: createEventTaskDefinition
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/createCustomBusinessProcessEventTaskDetail'
      responses:
        '200':
          description: Creates a new custom event task definition instance
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/customBusinessProcessEventTaskDetail'
        '400':
          description: 'Poossible Validations:


            -The name for event task definition is required and must be unique across all event task definitions.


            -VPS application is a required field.


            -VPS site is a required field.


            -The referenceIdValue must be unique across all VPS definitions.

            '
      security:
      - oAuth2:
        - write
        - read
      summary: Create event task definition
      x-summary-source: derived
    get:
      tags:
      - Event Task Definitions
      description: Returns summary of all event task definitions
      operationId: getEventTaskDefinition
      responses:
        '200':
          description: Returns summary of all event task definitions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/allCustomBusinessProcessEventTaskDetails'
      security:
      - oAuth2:
        - write
        - read
      summary: Get event task definition
      x-summary-source: derived
  /eventTaskDefinitions/{id}:
    get:
      tags:
      - Event Task Definitions
      description: Returns a event task definition
      operationId: viewEventTaskDefinition
      parameters:
      - name: id
        in: path
        description: The Workday Id of the event task definition
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Returns a event task definition for the Id supplied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/customBusinessProcessEventTaskDetail'
        '404':
          description: Not Found.
      security:
      - oAuth2:
        - write
        - read
      summary: View event task definition
      x-summary-source: derived
    put:
      tags:
      - Event Task Definitions
      description: Updates a event task definition.
      operationId: updateEventTaskDefinition
      parameters:
      - name: id
        in: path
        description: The Workday Id of the event task definition
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/editCustomBusinessProcessEventTaskDetail'
        description: Event task definition data to be updated.
        required: true
      responses:
        '200':
          description: Updates a event task definition for the Id supplied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/customBusinessProcessEventTaskDetail'
        '400':
          description: 'Possible Validations:


            -The name for event task definition is required and must be unique across all event task definitions.


            -VPS application is a required field.


            -VPS site is a required field.


            -The referenceIdValue must be unique across all event task definitions.

            '
      security:
      - oAuth2:
        - write
        - read
      summary: Update event task definition
      x-summary-source: derived
    patch:
      tags:
      - Event Task Definitions
      description: Updates a event task definition.
      operationId: patchEventTaskDefinition
      parameters:
      - name: id
        in: path
        description: The Workday Id of the event task definition
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/patchCustomBusinessProcessEventTaskDetail'
        description: Event task definition data to be updated.
        required: true
      responses:
        '200':
          description: Updates a event task definition for the Id supplied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/customBusinessProcessEventTaskDetail'
        '400':
          description: 'Possible Validations:


            -The name for event task definition is required and must be unique across all event task definitions.


            -VPS application is a required field.


            -VPS site is a required field.


            -The referenceIdValue must be unique across all event task definitions.

            '
      security:
      - oAuth2:
        - write
        - read
      summary: Patch event task definition
      x-summary-source: derived
    delete:
      tags:
      - Event Task Definitions
      description: Deletes a event task definition
      operationId: deleteEventTaskDefinition
      parameters:
      - name: id
        in: path
        description: The Workday Id of the event task definition
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Deletes a event task definition for the Id supplied
        '400':
          description: The event task definition cannot be deleted because it has references.
        '404':
          description: Not Found.
      security:
      - oAuth2:
        - write
        - read
      summary: Delete event task definition
      x-summary-source: derived
components:
  schemas:
    allCustomBusinessProcessEventTaskDetails:
      type: object
      properties:
        total:
          type: number
        data:
          type: array
          items:
            $ref: '#/components/schemas/customBusinessProcessEventTaskDetail'
    patchCustomBusinessProcessEventTaskDetail:
      type: object
      properties:
        name:
          type: string
        description:
          type: string
        vpsApplication:
          type: string
        vpsSite:
          type: string
        vpsRoute:
          type: string
        referenceIdValue:
          type: string
    editCustomBusinessProcessEventTaskDetail:
      type: object
      required:
      - vpsApplication
      - name
      - vpsSite
      properties:
        name:
          type: string
        description:
          type: string
        vpsApplication:
          type: string
        vpsSite:
          type: string
        vpsRoute:
          type: string
        referenceIdValue:
          type: string
    createCustomBusinessProcessEventTaskDetail:
      type: object
      required:
      - vpsApplication
      - name
      - vpsSite
      properties:
        name:
          type: string
        description:
          type: string
        vpsApplication:
          type: string
        vpsSite:
          type: string
        vpsRoute:
          type: string
        referenceIdValue:
          type: string
    customBusinessProcessEventTaskDetail:
      type: object
      required:
      - vpsApplication
      - name
      - vpsSite
      properties:
        id:
          type: string
        Event_Task_Definition_ID:
          type: string
        name:
          type: string
        description:
          type: string
        referenceIdValue:
          type: string
        vpsApplication:
          type: string
        vpsSite:
          type: string
        vpsRoute:
          type: string
  securitySchemes:
    oAuth2:
      type: oauth2
      description: Register an API Client
      flows:
        implicit:
          authorizationUrl: https://auth.api.workday.com/v1/authorize
          scopes:
            write: modify custom business process types
            read: read custom business process types

Workday Business Processes Event Task Definitions API

Operations 6

Documentation

Specifications

Schemas & Data

Other Resources