Boomi DataHub API

naftiko: 1.0.0-alpha2
info:
  label: Boomi DataHub API
  description: 'The Boomi DataHub REST API provides programmatic access to master data management operations. It consists
    of two layers: the Platform API for managing repositories, models, sources, and domains; and the Repository API for querying
    and manipulating golden records and staged entities. The Platform API uses Basic Authentication while the Repository API
    supports JWT authentication. Requests are subject to usage limits based on licensed connectors (1,000 times the number
    of connectors per 24 hours).'
  tags:
  - Boomi
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: boomi
    baseUri: https://mdh.boomi.com/mdh
    description: Boomi DataHub API HTTP API.
    authentication:
      type: basic
      username: '{{BOOMI_USERNAME}}'
      password: '{{BOOMI_PASSWORD}}'
    resources:
    - name: repositories
      path: /repositories
      operations:
      - name: listrepositories
        method: GET
        description: Boomi List repositories
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createrepository
        method: POST
        description: Boomi Create a repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: repositories-repositoryid
      path: /repositories/{repositoryId}
      operations:
      - name: getrepository
        method: GET
        description: Boomi Get a repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleterepository
        method: DELETE
        description: Boomi Delete a repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: repositories-repositoryid-models
      path: /repositories/{repositoryId}/models
      operations:
      - name: listmodels
        method: GET
        description: Boomi List models
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createmodel
        method: POST
        description: Boomi Create a model
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: repositories-repositoryid-models-modelid
      path: /repositories/{repositoryId}/models/{modelId}
      operations:
      - name: getmodel
        method: GET
        description: Boomi Get a model
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletemodel
        method: DELETE
        description: Boomi Delete a model
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: repositories-repositoryid-models-modelid-publish
      path: /repositories/{repositoryId}/models/{modelId}/publish
      operations:
      - name: publishmodel
        method: POST
        description: Boomi Publish a model
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: repositories-repositoryid-sources
      path: /repositories/{repositoryId}/sources
      operations:
      - name: listsources
        method: GET
        description: Boomi List sources
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createsource
        method: POST
        description: Boomi Create a source
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: repositories-repositoryid-universes-universeid-r
      path: /repositories/{repositoryId}/universes/{universeId}/records
      operations:
      - name: listgoldenrecords
        method: GET
        description: Boomi List golden records
        inputParameters:
        - name: pageSize
          in: query
          type: integer
          description: Number of records per page.
        - name: pageToken
          in: query
          type: string
          description: Pagination token from a previous response.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: repositories-repositoryid-universes-universeid-q
      path: /repositories/{repositoryId}/universes/{universeId}/quarantine
      operations:
      - name: listquarantineentries
        method: GET
        description: Boomi List quarantine entries
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: boomi-rest
    description: REST adapter for Boomi DataHub API.
    resources:
    - path: /repositories
      name: listrepositories
      operations:
      - method: GET
        name: listrepositories
        description: Boomi List repositories
        call: boomi.listrepositories
        outputParameters:
        - type: object
          mapping: $.
    - path: /repositories
      name: createrepository
      operations:
      - method: POST
        name: createrepository
        description: Boomi Create a repository
        call: boomi.createrepository
        outputParameters:
        - type: object
          mapping: $.
    - path: /repositories/{repositoryId}
      name: getrepository
      operations:
      - method: GET
        name: getrepository
        description: Boomi Get a repository
        call: boomi.getrepository
        outputParameters:
        - type: object
          mapping: $.
    - path: /repositories/{repositoryId}
      name: deleterepository
      operations:
      - method: DELETE
        name: deleterepository
        description: Boomi Delete a repository
        call: boomi.deleterepository
        outputParameters:
        - type: object
          mapping: $.
    - path: /repositories/{repositoryId}/models
      name: listmodels
      operations:
      - method: GET
        name: listmodels
        description: Boomi List models
        call: boomi.listmodels
        outputParameters:
        - type: object
          mapping: $.
    - path: /repositories/{repositoryId}/models
      name: createmodel
      operations:
      - method: POST
        name: createmodel
        description: Boomi Create a model
        call: boomi.createmodel
        outputParameters:
        - type: object
          mapping: $.
    - path: /repositories/{repositoryId}/models/{modelId}
      name: getmodel
      operations:
      - method: GET
        name: getmodel
        description: Boomi Get a model
        call: boomi.getmodel
        outputParameters:
        - type: object
          mapping: $.
    - path: /repositories/{repositoryId}/models/{modelId}
      name: deletemodel
      operations:
      - method: DELETE
        name: deletemodel
        description: Boomi Delete a model
        call: boomi.deletemodel
        outputParameters:
        - type: object
          mapping: $.
    - path: /repositories/{repositoryId}/models/{modelId}/publish
      name: publishmodel
      operations:
      - method: POST
        name: publishmodel
        description: Boomi Publish a model
        call: boomi.publishmodel
        outputParameters:
        - type: object
          mapping: $.
    - path: /repositories/{repositoryId}/sources
      name: listsources
      operations:
      - method: GET
        name: listsources
        description: Boomi List sources
        call: boomi.listsources
        outputParameters:
        - type: object
          mapping: $.
    - path: /repositories/{repositoryId}/sources
      name: createsource
      operations:
      - method: POST
        name: createsource
        description: Boomi Create a source
        call: boomi.createsource
        outputParameters:
        - type: object
          mapping: $.
    - path: /repositories/{repositoryId}/universes/{universeId}/records
      name: listgoldenrecords
      operations:
      - method: GET
        name: listgoldenrecords
        description: Boomi List golden records
        call: boomi.listgoldenrecords
        outputParameters:
        - type: object
          mapping: $.
    - path: /repositories/{repositoryId}/universes/{universeId}/quarantine
      name: listquarantineentries
      operations:
      - method: GET
        name: listquarantineentries
        description: Boomi List quarantine entries
        call: boomi.listquarantineentries
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: boomi-mcp
    transport: http
    description: MCP adapter for Boomi DataHub API for AI agent use.
    tools:
    - name: listrepositories
      description: Boomi List repositories
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: boomi.listrepositories
      outputParameters:
      - type: object
        mapping: $.
    - name: createrepository
      description: Boomi Create a repository
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: boomi.createrepository
      outputParameters:
      - type: object
        mapping: $.
    - name: getrepository
      description: Boomi Get a repository
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: boomi.getrepository
      outputParameters:
      - type: object
        mapping: $.
    - name: deleterepository
      description: Boomi Delete a repository
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: boomi.deleterepository
      outputParameters:
      - type: object
        mapping: $.
    - name: listmodels
      description: Boomi List models
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: boomi.listmodels
      outputParameters:
      - type: object
        mapping: $.
    - name: createmodel
      description: Boomi Create a model
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: boomi.createmodel
      outputParameters:
      - type: object
        mapping: $.
    - name: getmodel
      description: Boomi Get a model
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: boomi.getmodel
      outputParameters:
      - type: object
        mapping: $.
    - name: deletemodel
      description: Boomi Delete a model
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: boomi.deletemodel
      outputParameters:
      - type: object
        mapping: $.
    - name: publishmodel
      description: Boomi Publish a model
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: boomi.publishmodel
      outputParameters:
      - type: object
        mapping: $.
    - name: listsources
      description: Boomi List sources
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: boomi.listsources
      outputParameters:
      - type: object
        mapping: $.
    - name: createsource
      description: Boomi Create a source
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: boomi.createsource
      outputParameters:
      - type: object
        mapping: $.
    - name: listgoldenrecords
      description: Boomi List golden records
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: boomi.listgoldenrecords
      with:
        pageSize: tools.pageSize
        pageToken: tools.pageToken
      inputParameters:
      - name: pageSize
        type: integer
        description: Number of records per page.
      - name: pageToken
        type: string
        description: Pagination token from a previous response.
      outputParameters:
      - type: object
        mapping: $.
    - name: listquarantineentries
      description: Boomi List quarantine entries
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: boomi.listquarantineentries
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    BOOMI_USERNAME: BOOMI_USERNAME
    BOOMI_PASSWORD: BOOMI_PASSWORD