Workday Business Processes Prompt Values API

openapi: 3.2.0
info:
  title: businessProcess Prompt Values API
  description: The public APIs to access event actions and details
  version: v1
  x-workday-internal-source: xo
  x-workday-internal-routing: Public
  x-workday-internal-protected-usage-enabled: false
  x-workday-internal-service-container-id: b6729d1b232d10000cd0f346f6b90004
  x-api-evangelist-harvested: '2026-09-17'
  x-api-evangelist-source: https://developer.workday.com/bundles/rest-directory-ui/public/static/openApiFiles/businessProcess_v1_20260905_oas3.json
servers:
- url: https://{tenantHostname}/businessProcess/v1
  description: Workday tenant REST API host (API Gateway)
  variables:
    tenantHostname:
      default: wd2-impl-services1.workday.com
      description: Your Workday tenant API hostname, e.g. wd2-impl-services1.workday.com
tags:
- name: Prompt Values
  description: Retrieves instances that can be used as values for other endpoint parameters in this service.
paths:
  /values/sendBack/to/:
    parameters:
    - name: eventStep
      in: query
      schema:
        type: string
    - name: limit
      in: query
      description: The maximum number of objects in a single response. The default and maximum is 1000.
      schema:
        type: integer
        format: int64
    - name: offset
      in: query
      description: 'The zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.'
      schema:
        type: integer
        format: int64
    - name: search
      in: query
      description: A search string that matches display IDs. The search is case-insensitive and matches words that start with the given string.
      schema:
        type: string
    get:
      tags:
      - Prompt Values
      description: Retrieves instances that can be used as values for other endpoint parameters in this service.
      responses:
        '200':
          description: Successful response. A successful response can return no matched data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MULTIPLE_INSTANCE_MODEL_REFERENCE'
        '400':
          description: Invalid request. (https://community.workday.com/rest/error-messages)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VALIDATION_ERROR_MODEL_REFERENCE'
        '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'
        '403':
          description: User has insufficient permissions. (https://community.workday.com/rest/error-messages)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VALIDATION_ERROR_MODEL_REFERENCE'
        '404':
          description: Resource not found. (https://community.workday.com/rest/error-messages)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VALIDATION_ERROR_MODEL_REFERENCE'
        default:
          description: An error occurred.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ERROR_MODEL_REFERENCE'
      x-workday-internal-protected-usage-enabled: false
      x-workday-internal-try-enabled: 'false'
      summary: Get values send back to
      x-summary-source: derived
      operationId: getValuesSendBackTo
      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.
        descriptor:
          type: string
          description: The display name of the instance
          readOnly: true
        href:
          type: string
          description: A link to the instance
          readOnly: true
    VALIDATION_ERROR_MODEL_REFERENCE:
      allOf:
      - required:
        - error
        type: object
        properties:
          error:
            type: string
            description: A description of the error
          errors:
            type: array
            description: An array of validation errors
            items:
              $ref: '#/components/schemas/ERROR_MODEL_REFERENCE'
    ERROR_MODEL_REFERENCE:
      required:
      - error
      type: object
      properties:
        error:
          type: string
          description: A description of the error
        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
        field:
          type: string
          description: The field related to the error
        path:
          type: string
          description: The path of the field related to the error
        severity:
          type: string
          description: Severity of the validation (e.g. Critical, Warning).
        internalMessage:
          type: string
          description: Internal message providing additional context for the validation (e.g. representation content validation details).
    MULTIPLE_INSTANCE_MODEL_REFERENCE:
      type: object
      properties:
        total:
          type: integer
          format: int32
        data:
          type: array
          items:
            $ref: '#/components/schemas/INSTANCE_MODEL_REFERENCE'
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        implicit:
          authorizationUrl: https://{tenantAuthorizationHostname}/authorize
          scopes: {}