Greenhouse Harvest API — Organization (Departments, Offices, Users)

naftiko: 1.0.0-alpha2
info:
  label: Greenhouse Harvest API — Organization (Departments, Offices, Users)
  description: 'Greenhouse Harvest API — Departments, Offices, Users, Custom Fields, Sources, Tags, Rejection Reasons, and Prospect Pools.'
  tags:
  - Greenhouse
  - Harvest
  - Organization
  - ATS
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    GREENHOUSE_HARVEST_API_KEY: GREENHOUSE_HARVEST_API_KEY
capability:
  consumes:
  - type: http
    namespace: harvest-org
    baseUri: https://harvest.greenhouse.io/v1
    description: Organizational and configuration resources.
    resources:
    - name: departments
      path: /departments
      operations:
      - name: listdepartments
        method: GET
        description: List Departments
        outputRawFormat: json
        outputParameters: [ { name: result, type: object, value: $. } ]
      - name: createdepartment
        method: POST
        description: Create Department
        inputParameters: [ { name: body, in: body, type: object, required: true } ]
        outputRawFormat: json
        outputParameters: [ { name: result, type: object, value: $. } ]
    - name: offices
      path: /offices
      operations:
      - name: listoffices
        method: GET
        description: List Offices
        outputRawFormat: json
        outputParameters: [ { name: result, type: object, value: $. } ]
      - name: createoffice
        method: POST
        description: Create Office
        inputParameters: [ { name: body, in: body, type: object, required: true } ]
        outputRawFormat: json
        outputParameters: [ { name: result, type: object, value: $. } ]
    - name: users
      path: /users
      operations:
      - name: listusers
        method: GET
        description: List Users
        outputRawFormat: json
        outputParameters: [ { name: result, type: object, value: $. } ]
      - name: createuser
        method: POST
        description: Create User
        inputParameters: [ { name: body, in: body, type: object, required: true } ]
        outputRawFormat: json
        outputParameters: [ { name: result, type: object, value: $. } ]
    - name: custom-fields
      path: /custom_fields
      operations:
      - name: listcustomfields
        method: GET
        description: List Custom Fields
        outputRawFormat: json
        outputParameters: [ { name: result, type: object, value: $. } ]
    - name: sources
      path: /sources
      operations:
      - name: listsources
        method: GET
        description: List Sources
        outputRawFormat: json
        outputParameters: [ { name: result, type: object, value: $. } ]
    - name: rejection-reasons
      path: /rejection_reasons
      operations:
      - name: listrejectionreasons
        method: GET
        description: List Rejection Reasons
        outputRawFormat: json
        outputParameters: [ { name: result, type: object, value: $. } ]
    - name: prospect-pools
      path: /prospect_pools
      operations:
      - name: listprospectpools
        method: GET
        description: List Prospect Pools
        outputRawFormat: json
        outputParameters: [ { name: result, type: object, value: $. } ]
    authentication:
      type: basic
      username: '{{env.GREENHOUSE_HARVEST_API_KEY}}'
      password: ''
  exposes:
  - type: mcp
    namespace: harvest-org-mcp
    port: 9090
    transport: http
    tools:
    - name: greenhouse-list-departments
      description: List Departments
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: harvest-org.listdepartments
      outputParameters: [ { type: object, mapping: $. } ]
    - name: greenhouse-list-offices
      description: List Offices
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: harvest-org.listoffices
      outputParameters: [ { type: object, mapping: $. } ]
    - name: greenhouse-list-users
      description: List Users
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: harvest-org.listusers
      outputParameters: [ { type: object, mapping: $. } ]
    - name: greenhouse-list-custom-fields
      description: List Custom Fields
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: harvest-org.listcustomfields
      outputParameters: [ { type: object, mapping: $. } ]
    - name: greenhouse-list-sources
      description: List Candidate Sources
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: harvest-org.listsources
      outputParameters: [ { type: object, mapping: $. } ]
    - name: greenhouse-list-rejection-reasons
      description: List Rejection Reasons
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: harvest-org.listrejectionreasons
      outputParameters: [ { type: object, mapping: $. } ]
    - name: greenhouse-list-prospect-pools
      description: List Prospect Pools
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: harvest-org.listprospectpools
      outputParameters: [ { type: object, mapping: $. } ]