Workday Business Processes 03/11/2023 API

openapi: 3.2.0
info:
  title: Changelog for businessProcess 03/11/2023 API
  description: The public APIs to access event actions and details
  version: v1
servers:
- url: https://<tenantHostname>/businessProcess/v1
tags:
- name: 03/11/2023
  description: Changes for v2023.10
paths:
  2023.10/eventSteps/{ID}/toDo:
    post:
      tags:
      - 03/11/2023
      summary: Added new operation
      description: 'Posts a To Do event step with the specified ID. Specify whether to submit the To Do item or save it for later.In the request body, specify at least these required fields: {stepAction}.


        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'
      parameters:
      - name: ID
        in: path
        description: The Workday ID of the resource.
        required: true
        explode: false
        schema:
          type: string
          exampleSetFlag: false
          types:
          - string
      requestBody:
        content:
          '*/*':
            schema:
              $ref: '#/components/schemas/businessProcessEventStepTodo_33ae690d779b10001c98021b2aa90000'
              exampleSetFlag: false
            exampleSetFlag: false
        required: true
      responses:
        '201':
          description: Resource created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/businessProcessEventStepTodo_33ae690d779b10001c98021b2aa90000'
                exampleSetFlag: false
              exampleSetFlag: false
        '400':
          description: 'Invalid request. (https://community.workday.com/rest/error-messages)

            Error Code | Validation Message

            --- | ---

            A212 | This event step isn''t awaiting your action

            A1572 | Specify a To Do step.

            A1573 | You can''t comment on this business process type.

            A1574 | Specify Submit or Save for Later. This step type doesn''t support other actions.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VALIDATION_ERROR_MODEL_REFERENCE'
                exampleSetFlag: false
              exampleSetFlag: false
        '401':
          description: Invalid resource or operation. (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-codegen-request-body-name: businessProcessEventStepTodo
      operationId: post202310EventStepsByIDToDo
      x-operation-id-source: derived
components:
  schemas:
    INSTANCE_MODEL_REFERENCE:
      required:
      - id
      type: object
      properties:
        id:
          pattern: ^(([0-9a-f]{32})|(\S+=\S+))$
          type: string
          description: Workday Id or Reference Id of the instance.
          exampleSetFlag: false
          types:
          - string
        descriptor:
          type: string
          description: The display name of the instance
          readOnly: true
          exampleSetFlag: false
          types:
          - string
        href:
          type: string
          description: A link to the instance
          readOnly: true
          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
    stepAction_122be871d36110000539df507b410000:
      description: The status of the step
      exampleSetFlag: false
      allOf:
      - $ref: '#/components/schemas/INSTANCE_MODEL_REFERENCE'
        exampleSetFlag: false
      - type: object
        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
    businessProcessEventStepTodo_33ae690d779b10001c98021b2aa90000:
      exampleSetFlag: false
      allOf:
      - required:
        - stepAction
        type: object
        properties:
          stepAction:
            $ref: '#/components/schemas/stepAction_122be871d36110000539df507b410000'
            exampleSetFlag: false
          comment:
            type: string
            description: Last Comment
            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: {}