Workday Integration Workday Human Capital Management API — Workers

naftiko: 1.0.0-alpha2
info:
  label: Workday Integration Workday Human Capital Management API — Workers
  description: 'Workday Integration Workday Human Capital Management API — Workers. 11 operations. Lead operation: Workday
    Integration Retrieve workers in a supervisory organization. Self-contained Naftiko capability covering one Workday Integration
    business surface.'
  tags:
  - Workday Integration
  - Workers
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    WORKDAY_INTEGRATION_API_KEY: WORKDAY_INTEGRATION_API_KEY
capability:
  consumes:
  - type: http
    namespace: human-capital-management-workers
    baseUri: https://{baseUrl}/ccx/api/v1/{tenant}
    description: Workday Integration Workday Human Capital Management API — Workers business capability. Self-contained, no
      shared references.
    resources:
    - name: supervisoryOrganizations-ID-workers
      path: /supervisoryOrganizations/{ID}/workers
      operations:
      - name: getsupervisoryorganizationworkers
        method: GET
        description: Workday Integration Retrieve workers in a supervisory organization
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: workers
      path: /workers
      operations:
      - name: getworkers
        method: GET
        description: Workday Integration Retrieve a collection of workers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: workers-ID
      path: /workers/{ID}
      operations:
      - name: getworkerbyid
        method: GET
        description: Workday Integration Retrieve a single worker instance
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: workers-ID-businessTitleChanges
      path: /workers/{ID}/businessTitleChanges
      operations:
      - name: getworkerbusinesstitlechanges
        method: GET
        description: Workday Integration Retrieve business title changes for a worker
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createbusinesstitlechange
        method: POST
        description: Workday Integration Create a business title change
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: workers-ID-history
      path: /workers/{ID}/history
      operations:
      - name: getworkerhistory
        method: GET
        description: Workday Integration Retrieve history items for a worker
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: workers-ID-jobChanges
      path: /workers/{ID}/jobChanges
      operations:
      - name: createjobchange
        method: POST
        description: Workday Integration Create a job change for a worker
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: workers-ID-organizations
      path: /workers/{ID}/organizations
      operations:
      - name: getworkerorganizations
        method: GET
        description: Workday Integration Retrieve organizations for a worker
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: workers-ID-paySlips
      path: /workers/{ID}/paySlips
      operations:
      - name: getworkerpayslips
        method: GET
        description: Workday Integration Retrieve pay slips for a worker
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: workers-ID-reports
      path: /workers/{ID}/reports
      operations:
      - name: getworkerdirectreports
        method: GET
        description: Workday Integration Retrieve direct reports for a worker
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: workers-ID-supervisoryOrganizations
      path: /workers/{ID}/supervisoryOrganizations
      operations:
      - name: getworkersupervisoryorganizations
        method: GET
        description: Workday Integration Retrieve supervisory organizations managed by a worker
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.WORKDAY_INTEGRATION_API_KEY}}'
  exposes:
  - type: rest
    namespace: human-capital-management-workers-rest
    port: 8080
    description: REST adapter for Workday Integration Workday Human Capital Management API — Workers. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/supervisoryorganizations/{id}/workers
      name: supervisoryorganizations-id-workers
      description: REST surface for supervisoryOrganizations-ID-workers.
      operations:
      - method: GET
        name: getsupervisoryorganizationworkers
        description: Workday Integration Retrieve workers in a supervisory organization
        call: human-capital-management-workers.getsupervisoryorganizationworkers
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workers
      name: workers
      description: REST surface for workers.
      operations:
      - method: GET
        name: getworkers
        description: Workday Integration Retrieve a collection of workers
        call: human-capital-management-workers.getworkers
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workers/{id}
      name: workers-id
      description: REST surface for workers-ID.
      operations:
      - method: GET
        name: getworkerbyid
        description: Workday Integration Retrieve a single worker instance
        call: human-capital-management-workers.getworkerbyid
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workers/{id}/businesstitlechanges
      name: workers-id-businesstitlechanges
      description: REST surface for workers-ID-businessTitleChanges.
      operations:
      - method: GET
        name: getworkerbusinesstitlechanges
        description: Workday Integration Retrieve business title changes for a worker
        call: human-capital-management-workers.getworkerbusinesstitlechanges
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createbusinesstitlechange
        description: Workday Integration Create a business title change
        call: human-capital-management-workers.createbusinesstitlechange
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workers/{id}/history
      name: workers-id-history
      description: REST surface for workers-ID-history.
      operations:
      - method: GET
        name: getworkerhistory
        description: Workday Integration Retrieve history items for a worker
        call: human-capital-management-workers.getworkerhistory
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workers/{id}/jobchanges
      name: workers-id-jobchanges
      description: REST surface for workers-ID-jobChanges.
      operations:
      - method: POST
        name: createjobchange
        description: Workday Integration Create a job change for a worker
        call: human-capital-management-workers.createjobchange
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workers/{id}/organizations
      name: workers-id-organizations
      description: REST surface for workers-ID-organizations.
      operations:
      - method: GET
        name: getworkerorganizations
        description: Workday Integration Retrieve organizations for a worker
        call: human-capital-management-workers.getworkerorganizations
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workers/{id}/payslips
      name: workers-id-payslips
      description: REST surface for workers-ID-paySlips.
      operations:
      - method: GET
        name: getworkerpayslips
        description: Workday Integration Retrieve pay slips for a worker
        call: human-capital-management-workers.getworkerpayslips
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workers/{id}/reports
      name: workers-id-reports
      description: REST surface for workers-ID-reports.
      operations:
      - method: GET
        name: getworkerdirectreports
        description: Workday Integration Retrieve direct reports for a worker
        call: human-capital-management-workers.getworkerdirectreports
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workers/{id}/supervisoryorganizations
      name: workers-id-supervisoryorganizations
      description: REST surface for workers-ID-supervisoryOrganizations.
      operations:
      - method: GET
        name: getworkersupervisoryorganizations
        description: Workday Integration Retrieve supervisory organizations managed by a worker
        call: human-capital-management-workers.getworkersupervisoryorganizations
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: human-capital-management-workers-mcp
    port: 9090
    transport: http
    description: MCP adapter for Workday Integration Workday Human Capital Management API — Workers. One tool per consumed
      operation, routed inline through this capability's consumes block.
    tools:
    - name: workday-integration-retrieve-workers-supervisory
      description: Workday Integration Retrieve workers in a supervisory organization
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: human-capital-management-workers.getsupervisoryorganizationworkers
      outputParameters:
      - type: object
        mapping: $.
    - name: workday-integration-retrieve-collection-workers
      description: Workday Integration Retrieve a collection of workers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: human-capital-management-workers.getworkers
      outputParameters:
      - type: object
        mapping: $.
    - name: workday-integration-retrieve-single-worker
      description: Workday Integration Retrieve a single worker instance
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: human-capital-management-workers.getworkerbyid
      outputParameters:
      - type: object
        mapping: $.
    - name: workday-integration-retrieve-business-title
      description: Workday Integration Retrieve business title changes for a worker
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: human-capital-management-workers.getworkerbusinesstitlechanges
      outputParameters:
      - type: object
        mapping: $.
    - name: workday-integration-create-business-title
      description: Workday Integration Create a business title change
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: human-capital-management-workers.createbusinesstitlechange
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: workday-integration-retrieve-history-items
      description: Workday Integration Retrieve history items for a worker
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: human-capital-management-workers.getworkerhistory
      outputParameters:
      - type: object
        mapping: $.
    - name: workday-integration-create-job-change
      description: Workday Integration Create a job change for a worker
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: human-capital-management-workers.createjobchange
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: workday-integration-retrieve-organizations-worker
      description: Workday Integration Retrieve organizations for a worker
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: human-capital-management-workers.getworkerorganizations
      outputParameters:
      - type: object
        mapping: $.
    - name: workday-integration-retrieve-pay-slips
      description: Workday Integration Retrieve pay slips for a worker
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: human-capital-management-workers.getworkerpayslips
      outputParameters:
      - type: object
        mapping: $.
    - name: workday-integration-retrieve-direct-reports
      description: Workday Integration Retrieve direct reports for a worker
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: human-capital-management-workers.getworkerdirectreports
      outputParameters:
      - type: object
        mapping: $.
    - name: workday-integration-retrieve-supervisory-organizations
      description: Workday Integration Retrieve supervisory organizations managed by a worker
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: human-capital-management-workers.getworkersupervisoryorganizations
      outputParameters:
      - type: object
        mapping: $.