Orion Health Rhapsody Integration API — Lookup Tables

naftiko: 1.0.0-alpha2
info:
  label: Orion Health Rhapsody Integration API — Lookup Tables
  description: 'Orion Health Rhapsody Integration API — Lookup Tables. 4 operations. Lead operation: Orion Health List lookup
    tables. Self-contained Naftiko capability covering one Orion business surface.'
  tags:
  - Orion
  - Lookup Tables
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ORION_API_KEY: ORION_API_KEY
capability:
  consumes:
  - type: http
    namespace: rhapsody-lookup-tables
    baseUri: https://api.orionhealth.com/rhapsody
    description: Orion Health Rhapsody Integration API — Lookup Tables business capability. Self-contained, no shared references.
    resources:
    - name: lookup-tables
      path: /lookup-tables
      operations:
      - name: listlookuptables
        method: GET
        description: Orion Health List lookup tables
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: search
          in: query
          type: string
          description: Search by table name
    - name: lookup-tables-tableId
      path: /lookup-tables/{tableId}
      operations:
      - name: getlookuptable
        method: GET
        description: Orion Health Get lookup table contents
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: tableId
          in: path
          type: integer
          required: true
      - name: updatelookuptable
        method: PUT
        description: Orion Health Update lookup table contents
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: tableId
          in: path
          type: integer
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: lookup-tables-tableId-lookup
      path: /lookup-tables/{tableId}/lookup
      operations:
      - name: lookupvalue
        method: GET
        description: Orion Health Look up a value
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: tableId
          in: path
          type: integer
          required: true
        - name: key
          in: query
          type: string
          description: Lookup key
          required: true
        - name: column
          in: query
          type: string
          description: Column name to return
    authentication:
      type: bearer
      token: '{{env.ORION_API_KEY}}'
  exposes:
  - type: rest
    namespace: rhapsody-lookup-tables-rest
    port: 8080
    description: REST adapter for Orion Health Rhapsody Integration API — Lookup Tables. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/lookup-tables
      name: lookup-tables
      description: REST surface for lookup-tables.
      operations:
      - method: GET
        name: listlookuptables
        description: Orion Health List lookup tables
        call: rhapsody-lookup-tables.listlookuptables
        with:
          search: rest.search
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/lookup-tables/{tableid}
      name: lookup-tables-tableid
      description: REST surface for lookup-tables-tableId.
      operations:
      - method: GET
        name: getlookuptable
        description: Orion Health Get lookup table contents
        call: rhapsody-lookup-tables.getlookuptable
        with:
          tableId: rest.tableId
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updatelookuptable
        description: Orion Health Update lookup table contents
        call: rhapsody-lookup-tables.updatelookuptable
        with:
          tableId: rest.tableId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/lookup-tables/{tableid}/lookup
      name: lookup-tables-tableid-lookup
      description: REST surface for lookup-tables-tableId-lookup.
      operations:
      - method: GET
        name: lookupvalue
        description: Orion Health Look up a value
        call: rhapsody-lookup-tables.lookupvalue
        with:
          tableId: rest.tableId
          key: rest.key
          column: rest.column
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: rhapsody-lookup-tables-mcp
    port: 9090
    transport: http
    description: MCP adapter for Orion Health Rhapsody Integration API — Lookup Tables. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: orion-health-list-lookup-tables
      description: Orion Health List lookup tables
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rhapsody-lookup-tables.listlookuptables
      with:
        search: tools.search
      outputParameters:
      - type: object
        mapping: $.
    - name: orion-health-get-lookup-table
      description: Orion Health Get lookup table contents
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rhapsody-lookup-tables.getlookuptable
      with:
        tableId: tools.tableId
      outputParameters:
      - type: object
        mapping: $.
    - name: orion-health-update-lookup-table
      description: Orion Health Update lookup table contents
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: rhapsody-lookup-tables.updatelookuptable
      with:
        tableId: tools.tableId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: orion-health-look-up-value
      description: Orion Health Look up a value
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rhapsody-lookup-tables.lookupvalue
      with:
        tableId: tools.tableId
        key: tools.key
        column: tools.column
      outputParameters:
      - type: object
        mapping: $.