naftiko: 1.0.0-alpha2
info:
  label: Workday Recruiting Requisition Management
  description: Hiring manager and recruiter workflow for opening, modifying, freezing, and closing job requisitions and evergreen
    requisitions, creating positions in the position management staffing model, and posting jobs to internal and external
    career sites.
  tags:
  - Workday
  - Recruiting
  - Job Requisitions
  - Job Postings
  - Positions
  - HCM
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    WORKDAY_RECRUITING_TOKEN: WORKDAY_RECRUITING_TOKEN
    WORKDAY_TENANT: WORKDAY_TENANT
capability:
  consumes:
  - type: http
    namespace: recruiting
    baseUri: https://{{WORKDAY_TENANT}}.workday.com/ccx/api/recruiting/v41.2
    description: Workday Recruiting REST API for managing the full hiring lifecycle.
    authentication:
      type: bearer
      token: '{{WORKDAY_RECRUITING_TOKEN}}'
    resources:
    - name: job-requisitions
      path: /jobRequisitions
      description: Job requisition collection
      operations:
      - name: list-job-requisitions
        method: GET
        description: Retrieve a collection of job requisitions with optional filters
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        - name: status
          in: query
          type: string
          required: false
          description: Filter by status (Open, Filled, Frozen, Closed, Draft)
        - name: supervisoryOrganization
          in: query
          type: string
          required: false
          description: Filter by supervisory organization Workday ID
        - name: updatedFrom
          in: query
          type: string
          required: false
          description: Return requisitions updated on or after this date-time
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-job-requisition
        method: POST
        description: Create a new job requisition for a position
        body:
          type: json
          data:
            title: '{{tools.title}}'
            jobProfile: '{{tools.jobProfile}}'
            position: '{{tools.position}}'
            supervisoryOrganization: '{{tools.supervisoryOrganization}}'
            hiringManager: '{{tools.hiringManager}}'
            recruiter: '{{tools.recruiter}}'
            numberOfOpenings: '{{tools.numberOfOpenings}}'
            location: '{{tools.location}}'
            workerType: '{{tools.workerType}}'
            timeType: '{{tools.timeType}}'
            targetHireDate: '{{tools.targetHireDate}}'
            jobDescription: '{{tools.jobDescription}}'
            qualifications: '{{tools.qualifications}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: job-requisition-by-id
      path: /jobRequisitions/{jobRequisitionId}
      description: Individual job requisition
      operations:
      - name: get-job-requisition
        method: GET
        description: Retrieve details of a specific job requisition
        inputParameters:
        - name: jobRequisitionId
          in: path
          type: string
          required: true
          description: Job requisition Workday ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: edit-job-requisition
        method: PATCH
        description: Update an open job requisition
        inputParameters:
        - name: jobRequisitionId
          in: path
          type: string
          required: true
          description: Job requisition Workday ID
        body:
          type: json
          data:
            title: '{{tools.title}}'
            jobProfile: '{{tools.jobProfile}}'
            numberOfOpenings: '{{tools.numberOfOpenings}}'
            location: '{{tools.location}}'
            workerType: '{{tools.workerType}}'
            timeType: '{{tools.timeType}}'
            targetHireDate: '{{tools.targetHireDate}}'
            jobDescription: '{{tools.jobDescription}}'
            qualifications: '{{tools.qualifications}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: job-requisition-close
      path: /jobRequisitions/{jobRequisitionId}/close
      description: Close a job requisition
      operations:
      - name: close-job-requisition
        method: POST
        description: Close a job requisition that has no pending events
        inputParameters:
        - name: jobRequisitionId
          in: path
          type: string
          required: true
          description: Job requisition Workday ID
        body:
          type: json
          data:
            closeReason: '{{tools.closeReason}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: job-requisition-freeze
      path: /jobRequisitions/{jobRequisitionId}/freeze
      description: Freeze or unfreeze a job requisition
      operations:
      - name: manage-job-requisition-freeze
        method: POST
        description: Freeze or unfreeze a job requisition
        inputParameters:
        - name: jobRequisitionId
          in: path
          type: string
          required: true
          description: Job requisition Workday ID
        body:
          type: json
          data:
            freeze: '{{tools.freeze}}'
            reason: '{{tools.reason}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: evergreen-requisitions
      path: /evergreenRequisitions
      description: Evergreen requisition collection
      operations:
      - name: list-evergreen-requisitions
        method: GET
        description: Retrieve a collection of evergreen requisitions
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-evergreen-requisition
        method: POST
        description: Create a new evergreen requisition for ongoing hiring needs
        body:
          type: json
          data:
            title: '{{tools.title}}'
            jobProfile: '{{tools.jobProfile}}'
            supervisoryOrganization: '{{tools.supervisoryOrganization}}'
            hiringManager: '{{tools.hiringManager}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: evergreen-requisition-by-id
      path: /evergreenRequisitions/{evergreenRequisitionId}
      description: Individual evergreen requisition
      operations:
      - name: get-evergreen-requisition
        method: GET
        description: Retrieve details of a specific evergreen requisition
        inputParameters:
        - name: evergreenRequisitionId
          in: path
          type: string
          required: true
          description: Evergreen requisition Workday ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: evergreen-requisition-close
      path: /evergreenRequisitions/{evergreenRequisitionId}/close
      description: Close an evergreen requisition
      operations:
      - name: close-evergreen-requisition
        method: POST
        description: Close an evergreen requisition with no pending events
        inputParameters:
        - name: evergreenRequisitionId
          in: path
          type: string
          required: true
          description: Evergreen requisition Workday ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: candidates
      path: /candidates
      description: Candidate collection
      operations:
      - name: list-candidates
        method: GET
        description: Retrieve a collection of candidates with optional filters
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        - name: updatedFrom
          in: query
          type: string
          required: false
          description: Return candidates updated on or after this date-time
        - name: name
          in: query
          type: string
          required: false
          description: Filter candidates by name (partial match)
        - name: email
          in: query
          type: string
          required: false
          description: Filter candidates by email address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-candidate
        method: POST
        description: Create a new candidate record
        body:
          type: json
          data:
            firstName: '{{tools.firstName}}'
            lastName: '{{tools.lastName}}'
            email: '{{tools.email}}'
            phone: '{{tools.phone}}'
            address: '{{tools.address}}'
            source: '{{tools.source}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: candidate-by-id
      path: /candidates/{candidateId}
      description: Individual candidate
      operations:
      - name: get-candidate
        method: GET
        description: Retrieve details of a specific candidate
        inputParameters:
        - name: candidateId
          in: path
          type: string
          required: true
          description: Candidate Workday ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-candidate
        method: PATCH
        description: Update an existing candidate record
        inputParameters:
        - name: candidateId
          in: path
          type: string
          required: true
          description: Candidate Workday ID
        body:
          type: json
          data:
            firstName: '{{tools.firstName}}'
            lastName: '{{tools.lastName}}'
            email: '{{tools.email}}'
            phone: '{{tools.phone}}'
            address: '{{tools.address}}'
            source: '{{tools.source}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: candidate-attachments
      path: /candidates/{candidateId}/attachments
      description: Candidate attachments
      operations:
      - name: list-candidate-attachments
        method: GET
        description: Retrieve attachments for a candidate
        inputParameters:
        - name: candidateId
          in: path
          type: string
          required: true
          description: Candidate Workday ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: add-candidate-attachment
        method: POST
        description: Upload an attachment to a candidate record
        inputParameters:
        - name: candidateId
          in: path
          type: string
          required: true
          description: Candidate Workday ID
        body:
          type: multipart
          data:
            file: '{{tools.file}}'
            category: '{{tools.category}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: candidate-photo
      path: /candidates/{candidateId}/photo
      description: Candidate photo
      operations:
      - name: get-candidate-photo
        method: GET
        description: Retrieve the candidate photo
        inputParameters:
        - name: candidateId
          in: path
          type: string
          required: true
          description: Candidate Workday ID
        outputRawFormat: binary
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-candidate-photo
        method: PUT
        description: Upload or replace the candidate photo
        inputParameters:
        - name: candidateId
          in: path
          type: string
          required: true
          description: Candidate Workday ID
        body:
          type: binary
          data:
            file: '{{tools.file}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: candidate-assess
      path: /candidates/{candidateId}/assess
      description: Candidate assessment
      operations:
      - name: assess-candidate
        method: POST
        description: Create or modify a candidate assessment
        inputParameters:
        - name: candidateId
          in: path
          type: string
          required: true
          description: Candidate Workday ID
        body:
          type: json
          data:
            assessmentCategory: '{{tools.assessmentCategory}}'
            result: '{{tools.result}}'
            score: '{{tools.score}}'
            comments: '{{tools.comments}}'
            assessedOn: '{{tools.assessedOn}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: candidate-refer
      path: /candidates/{candidateId}/refer
      description: Candidate referral
      operations:
      - name: refer-candidate
        method: POST
        description: Submit a candidate referral from an existing worker
        inputParameters:
        - name: candidateId
          in: path
          type: string
          required: true
          description: Candidate Workday ID
        body:
          type: json
          data:
            jobRequisition: '{{tools.jobRequisition}}'
            referrer: '{{tools.referrer}}'
            referralComments: '{{tools.referralComments}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: job-applications
      path: /jobApplications
      description: Job application collection
      operations:
      - name: list-job-applications
        method: GET
        description: Retrieve a collection of job applications with optional filters
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        - name: jobRequisition
          in: query
          type: string
          required: false
          description: Filter by job requisition Workday ID
        - name: candidate
          in: query
          type: string
          required: false
          description: Filter by candidate Workday ID
        - name: stage
          in: query
          type: string
          required: false
          description: Filter by recruiting stage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: job-application-by-id
      path: /jobApplications/{jobApplicationId}
      description: Individual job application
      operations:
      - name: get-job-application
        method: GET
        description: Retrieve details of a specific job application
        inputParameters:
        - name: jobApplicationId
          in: path
          type: string
          required: true
          description: Job application Workday ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: job-application-move
      path: /jobApplications/{jobApplicationId}/move
      description: Move candidate to a different stage
      operations:
      - name: move-candidate-stage
        method: POST
        description: Move a candidate to a different recruiting or disposition stage
        inputParameters:
        - name: jobApplicationId
          in: path
          type: string
          required: true
          description: Job application Workday ID
        body:
          type: json
          data:
            stage: '{{tools.stage}}'
            reason: '{{tools.reason}}'
            comments: '{{tools.comments}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: job-application-offer
      path: /jobApplications/{jobApplicationId}/offer
      description: Initiate an employment offer
      operations:
      - name: initiate-offer
        method: POST
        description: Initiate an employment offer for a job application
        inputParameters:
        - name: jobApplicationId
          in: path
          type: string
          required: true
          description: Job application Workday ID
        body:
          type: json
          data:
            proposedStartDate: '{{tools.proposedStartDate}}'
            compensationAmount: '{{tools.compensationAmount}}'
            compensationFrequency: '{{tools.compensationFrequency}}'
            currency: '{{tools.currency}}'
            expirationDate: '{{tools.expirationDate}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: job-postings
      path: /jobPostings
      description: Job posting collection
      operations:
      - name: list-job-postings
        method: GET
        description: Retrieve a collection of job postings with optional filters
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        - name: jobRequisition
          in: query
          type: string
          required: false
          description: Filter by job requisition Workday ID
        - name: postingSite
          in: query
          type: string
          required: false
          description: Filter by posting site Workday ID
        - name: active
          in: query
          type: boolean
          required: false
          description: Filter by active posting status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: job-posting-by-id
      path: /jobPostings/{jobPostingId}
      description: Individual job posting
      operations:
      - name: get-job-posting
        method: GET
        description: Retrieve details of a specific job posting
        inputParameters:
        - name: jobPostingId
          in: path
          type: string
          required: true
          description: Job posting Workday ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-job-posting
        method: PATCH
        description: Update an existing job posting
        inputParameters:
        - name: jobPostingId
          in: path
          type: string
          required: true
          description: Job posting Workday ID
        body:
          type: json
          data:
            startDate: '{{tools.startDate}}'
            endDate: '{{tools.endDate}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: job-posting-post
      path: /jobPostings/{jobPostingId}/post
      description: Post a job to career sites
      operations:
      - name: post-job
        method: POST
        description: Post a job to internal and external career sites
        inputParameters:
        - name: jobPostingId
          in: path
          type: string
          required: true
          description: Job posting Workday ID
        body:
          type: json
          data:
            postingSites: '{{tools.postingSites}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: job-posting-unpost
      path: /jobPostings/{jobPostingId}/unpost
      description: Unpost a job from career sites
      operations:
      - name: unpost-job
        method: POST
        description: Remove a job posting from career sites
        inputParameters:
        - name: jobPostingId
          in: path
          type: string
          required: true
          description: Job posting Workday ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: interviews
      path: /interviews
      description: Interview collection
      operations:
      - name: list-interviews
        method: GET
        description: Retrieve a collection of scheduled interviews with optional filters
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        - name: jobApplication
          in: query
          type: string
          required: false
          description: Filter by job application Workday ID
        - name: dateFrom
          in: query
          type: string
          required: false
          description: Return interviews scheduled on or after this date
        - name: dateTo
          in: query
          type: string
          required: false
          description: Return interviews scheduled on or before this date
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: schedule-interview
        method: POST
        description: Schedule a new interview for a job application
        body:
          type: json
          data:
            jobApplication: '{{tools.jobApplication}}'
            interviewType: '{{tools.interviewType}}'
            scheduledDate: '{{tools.scheduledDate}}'
            startTime: '{{tools.startTime}}'
            endTime: '{{tools.endTime}}'
            interviewers: '{{tools.interviewers}}'
            location: '{{tools.location}}'
            webConferenceUrl: '{{tools.webConferenceUrl}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: interview-by-id
      path: /interviews/{interviewId}
      description: Individual interview
      operations:
      - name: get-interview
        method: GET
        description: Retrieve details of a specific interview
        inputParameters:
        - name: interviewId
          in: path
          type: string
          required: true
          description: Interview Workday ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: interview-feedback
      path: /interviews/{interviewId}/feedback
      description: Interview feedback
      operations:
      - name: list-interview-feedback
        method: GET
        description: Retrieve feedback submitted for an interview
        inputParameters:
        - name: interviewId
          in: path
          type: string
          required: true
          description: Interview Workday ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: submit-interview-feedback
        method: POST
        description: Submit feedback for a completed interview
        inputParameters:
        - name: interviewId
          in: path
          type: string
          required: true
          description: Interview Workday ID
        body:
          type: json
          data:
            overallRating: '{{tools.overallRating}}'
            competencyRatings: '{{tools.competencyRatings}}'
            comments: '{{tools.comments}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: background-checks
      path: /backgroundChecks
      description: Background check collection
      operations:
      - name: list-background-checks
        method: GET
        description: Retrieve a collection of background check results
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        - name: candidate
          in: query
          type: string
          required: false
          description: Filter by candidate Workday ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: submit-background-check
        method: POST
        description: Load background check results from an external provider
        body:
          type: json
          data:
            candidate: '{{tools.candidate}}'
            jobApplication: '{{tools.jobApplication}}'
            package: '{{tools.package}}'
            status: '{{tools.status}}'
            result: '{{tools.result}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: background-check-packages
      path: /backgroundCheckPackages
      description: Background check package collection
      operations:
      - name: list-background-check-packages
        method: GET
        description: Retrieve available background check packages
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: recruiting-agencies
      path: /recruitingAgencies
      description: Recruiting agency collection
      operations:
      - name: list-recruiting-agencies
        method: GET
        description: Retrieve a collection of recruiting agencies
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: recruiting-agency-by-id
      path: /recruitingAgencies/{recruitingAgencyId}
      description: Individual recruiting agency
      operations:
      - name: get-recruiting-agency
        method: GET
        description: Retrieve details of a specific recruiting agency
        inputParameters:
        - name: recruitingAgencyId
          in: path
          type: string
          required: true
          description: Recruiting agency Workday ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: recruiting-agency-candidates
      path: /recruitingAgencies/{recruitingAgencyId}/candidates
      description: Submit candidates from a recruiting agency
      operations:
      - name: submit-agency-candidate
        method: POST
        description: Submit a candidate from a recruiting agency for a job requisition
        inputParameters:
        - name: recruitingAgencyId
          in: path
          type: string
          required: true
          description: Recruiting agency Workday ID
        body:
          type: json
          data:
            candidate: '{{tools.candidate}}'
            jobRequisition: '{{tools.jobRequisition}}'
            agencyUser: '{{tools.agencyUser}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: applicants
      path: /applicants
      description: Applicant collection
      operations:
      - name: list-applicants
        method: GET
        description: Retrieve pre-hire and applicant records
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: applicants-import
      path: /applicants/import
      description: Bulk applicant import
      operations:
      - name: import-applicants
        method: POST
        description: High-volume applicant import for asynchronous bulk loading
        body:
          type: json
          data:
            applicants: '{{tools.applicants}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: positions
      path: /positions
      description: Position management
      operations:
      - name: list-positions
        method: GET
        description: Retrieve position management positions
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-position
        method: POST
        description: Create and open a new position
        body:
          type: json
          data:
            title: '{{tools.title}}'
            jobProfile: '{{tools.jobProfile}}'
            supervisoryOrganization: '{{tools.supervisoryOrganization}}'
            location: '{{tools.location}}'
            workerType: '{{tools.workerType}}'
            timeType: '{{tools.timeType}}'
            availableDate: '{{tools.availableDate}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: job-posting-sites
      path: /jobPostingSites
      description: Job posting site configuration
      operations:
      - name: list-job-posting-sites
        method: GET
        description: Retrieve available job posting sites
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: questionnaires
      path: /questionnaires
      description: Recruiting questionnaires
      operations:
      - name: list-questionnaires
        method: GET
        description: Retrieve recruiting questionnaires for screening and assessment
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: veteran-statuses
      path: /veteranStatuses
      description: Veteran status reference values
      operations:
      - name: list-veteran-statuses
        method: GET
        description: Retrieve veteran status reference values for EEO reporting
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: requisition-management-api
    description: Unified REST API for opening, modifying, and posting job requisitions.
    resources:
    - path: /v1/job-requisitions
      name: job-requisitions
      description: Job requisitions
      operations:
      - method: GET
        name: list-job-requisitions
        description: List job requisitions
        call: recruiting.list-job-requisitions
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-job-requisition
        description: Create a job requisition
        call: recruiting.create-job-requisition
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/job-requisitions/{jobRequisitionId}
      name: job-requisition-by-id
      description: Individual job requisition
      operations:
      - method: GET
        name: get-job-requisition
        description: Get a job requisition
        call: recruiting.get-job-requisition
        with:
          jobRequisitionId: rest.jobRequisitionId
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: edit-job-requisition
        description: Edit a job requisition
        call: recruiting.edit-job-requisition
        with:
          jobRequisitionId: rest.jobRequisitionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/job-requisitions/{jobRequisitionId}/close
      name: job-requisition-close
      description: Close a job requisition
      operations:
      - method: POST
        name: close-job-requisition
        description: Close a job requisition
        call: recruiting.close-job-requisition
        with:
          jobRequisitionId: rest.jobRequisitionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/job-requisitions/{jobRequisitionId}/freeze
      name: job-requisition-freeze
      description: Freeze or unfreeze a job requisition
      operations:
      - method: POST
        name: manage-job-requisition-freeze
        description: Freeze or unfreeze a job requisition
        call: recruiting.manage-job-requisition-freeze
        with:
          jobRequisitionId: rest.jobRequisitionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/evergreen-requisitions
      name: evergreen-requisitions
      description: Evergreen requisitions
      operations:
      - method: GET
        name: list-evergreen-requisitions
        description: List evergreen requisitions
        call: recruiting.list-evergreen-requisitions
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-evergreen-requisition
        description: Create an evergreen requisition
        call: recruiting.create-evergreen-requisition
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/evergreen-requisitions/{evergreenRequisitionId}
      name: evergreen-requisition-by-id
      description: Individual evergreen requisition
      operations:
      - method: GET
        name: get-evergreen-requisition
        description: Get an evergreen requisition
        call: recruiting.get-evergreen-requisition
        with:
          evergreenRequisitionId: rest.evergreenRequisitionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/evergreen-requisitions/{evergreenRequisitionId}/close
      name: evergreen-requisition-close
      description: Close an evergreen requisition
      operations:
      - method: POST
        name: close-evergreen-requisition
        description: Close an evergreen requisition
        call: recruiting.close-evergreen-requisition
        with:
          evergreenRequisitionId: rest.evergreenRequisitionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/positions
      name: positions
      description: Positions
      operations:
      - method: GET
        name: list-positions
        description: List positions
        call: recruiting.list-positions
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-position
        description: Create a position
        call: recruiting.create-position
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/job-postings
      name: job-postings
      description: Job postings
      operations:
      - method: GET
        name: list-job-postings
        description: List job postings
        call: recruiting.list-job-postings
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/job-postings/{jobPostingId}
      name: job-posting-by-id
      description: Individual job posting
      operations:
      - method: GET
        name: get-job-posting
        description: Get a job posting
        call: recruiting.get-job-posting
        with:
          jobPostingId: rest.jobPostingId
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: update-job-posting
        description: Update a job posting
        call: recruiting.update-job-posting
        with:
          jobPostingId: rest.jobPostingId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/job-postings/{jobPostingId}/post
      name: job-posting-post
      description: Post a job to career sites
      operations:
      - method: POST
        name: post-job
        description: Post a job to career sites
        call: recruiting.post-job
        with:
          jobPostingId: rest.jobPostingId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/job-postings/{jobPostingId}/unpost
      name: job-posting-unpost
      description: Unpost a job from career sites
      operations:
      - method: POST
        name: unpost-job
        description: Unpost a job from career sites
        call: recruiting.unpost-job
        with:
          jobPostingId: rest.jobPostingId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: requisition-management-mcp
    transport: http
    description: MCP server for AI-assisted job requisition opening, posting, and lifecycle management.
    tools:
    - name: list-job-requisitions
      description: List job requisitions with optional filters by status, organization, or update date
      hints:
        readOnly: true
        idempotent: true
      call: recruiting.list-job-requisitions
      outputParameters:
      - type: object
        mapping: $.
    - name: create-job-requisition
      description: Create a new job requisition for an open position
      hints:
        readOnly: false
        idempotent: false
      call: recruiting.create-job-requisition
      outputParameters:
      - type: object
        mapping: $.
    - name: get-job-requisition
      description: Get details of a specific job requisition
      hints:
        readOnly: true
        idempotent: true
      call: recruiting.get-job-requisition
      with:
        jobRequisitionId: tools.jobRequisitionId
      outputParameters:
      - type: object
        mapping: $.
    - name: edit-job-requisition
      description: Edit an open job requisition
      hints:
        readOnly: false
        idempotent: true
      call: recruiting.edit-job-requisition
      with:
        jobRequisitionId: tools.jobRequisitionId
      outputParameters:
      - type: object
        mapping: $.
    - name: close-job-requisition
      description: Close a job requisition that has no pending events
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: recruiting.close-job-requisition
      with:
        jobRequisitionId: tools.jobRequisitionId
      outputParameters:
      - type: object
        mapping: $.
    - name: manage-job-requisition-freeze
      description: Freeze or unfreeze a job requisition to halt or resume hiring
      hints:
        readOnly: false
        idempotent: true
      call: recruiting.manage-job-requisition-freeze
      with:
        jobRequisitionId: tools.jobRequisitionId
      outputParameters:
      - type: object
        mapping: $.
    - name: list-evergreen-requisitions
      description: List evergreen requisitions used for ongoing hiring needs
      hints:
        readOnly: true
        idempotent: true
      call: recruiting.list-evergreen-requisitions
      outputParameters:
      - type: object
        mapping: $.
    - name: create-evergreen-requisition
      description: Create a new evergreen requisition for ongoing hiring needs
      hints:
        readOnly: false
        idempotent: false
      call: recruiting.create-evergreen-requisition
      outputParameters:
      - type: object
        mapping: $.
    - name: get-evergreen-requisition
      description: Get details of a specific evergreen requisition
      hints:
        readOnly: true
        idempotent: true
      call: recruiting.get-evergreen-requisition
      with:
        evergreenRequisitionId: tools.evergreenRequisitionId
      outputParameters:
      - type: object
        mapping: $.
    - name: close-evergreen-requisition
      description: Close an evergreen requisition with no pending events
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: recruiting.close-evergreen-requisition
      with:
        evergreenRequisitionId: tools.evergreenRequisitionId
      outputParameters:
      - type: object
        mapping: $.
    - name: list-positions
      description: List position management positions and their fill status
      hints:
        readOnly: true
        idempotent: true
      call: recruiting.list-positions
      outputParameters:
      - type: object
        mapping: $.
    - name: create-position
      description: Create and open a new position in the position management staffing model
      hints:
        readOnly: false
        idempotent: false
      call: recruiting.create-position
      outputParameters:
      - type: object
        mapping: $.
    - name: list-job-postings
      description: List job postings with optional filters by requisition or posting site
      hints:
        readOnly: true
        idempotent: true
      call: recruiting.list-job-postings
      outputParameters:
      - type: object
        mapping: $.
    - name: get-job-posting
      description: Get details of a specific job posting
      hints:
        readOnly: true
        idempotent: true
      call: recruiting.get-job-posting
      with:
        jobPostingId: tools.jobPostingId
      outputParameters:
      - type: object
        mapping: $.
    - name: update-job-posting
      description: Update an existing job posting (start/end dates)
      hints:
        readOnly: false
        idempotent: true
      call: recruiting.update-job-posting
      with:
        jobPostingId: tools.jobPostingId
      outputParameters:
      - type: object
        mapping: $.
    - name: post-job
      description: Post a job to internal and external career sites
      hints:
        readOnly: false
        idempotent: true
      call: recruiting.post-job
      with:
        jobPostingId: tools.jobPostingId
      outputParameters:
      - type: object
        mapping: $.
    - name: unpost-job
      description: Remove a job posting from career sites
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: recruiting.unpost-job
      with:
        jobPostingId: tools.jobPostingId
      outputParameters:
      - type: object
        mapping: $.