naftiko: 1.0.0-alpha2
info:
  label: Fintecture OAC API — Organisation Nodes
  description: 'Fintecture OAC API — Organisation Nodes. 6 operations. Lead operation: Create Organisation Node.'
  tags: [Fintecture, OAC, Organisations, Beta]
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      FINTECTURE_OAC_TOKEN: FINTECTURE_OAC_TOKEN
capability:
  consumes:
    - type: http
      namespace: oac-organisation-nodes
      baseUri: https://api.fintecture.com
      description: Beta hierarchical organisation node tree management.
      resources:
        - name: v1-organisation-nodes
          path: /v1/organisation-nodes
          operations:
            - name: postorganisationnodes
              method: POST
              description: Create Organisation Node
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: '$.' }]
              inputParameters: [{ name: body, in: body, required: true }]
        - name: v1-organisation-node
          path: /v1/organisation-nodes/{organisation_node_id}
          operations:
            - name: getorganisationnodebyid
              method: GET
              description: Get Organisation
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: '$.' }]
              inputParameters: [{ name: organisation_node_id, in: path, required: true }]
            - name: patchorganisationnodebyid
              method: PATCH
              description: Update Organisation
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: '$.' }]
              inputParameters:
                - { name: organisation_node_id, in: path, required: true }
                - { name: body, in: body, required: true }
            - name: deleteorganisationnodebyid
              method: DELETE
              description: Remove Organisation
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: '$.' }]
              inputParameters: [{ name: organisation_node_id, in: path, required: true }]
        - name: v1-organisation-tree
          path: /v1/organisation-nodes/{organisation_node_id}/tree
          operations:
            - name: getorganisationtree
              method: GET
              description: Get Organisation Tree
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: '$.' }]
              inputParameters: [{ name: organisation_node_id, in: path, required: true }]
        - name: v1-organisation-companies
          path: /v1/organisation-nodes/{organisation_node_id}/companies
          operations:
            - name: getorganisationnodecompanies
              method: GET
              description: Get Companies In Organisation
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: '$.' }]
              inputParameters: [{ name: organisation_node_id, in: path, required: true }]
      authentication:
        type: bearer
        value: '{{env.FINTECTURE_OAC_TOKEN}}'
        placement: header
  exposes:
    - type: rest
      namespace: oac-organisation-nodes-rest
      port: 8080
      resources:
        - path: /v1/v1/organisation-nodes
          name: v1-organisation-nodes
          operations:
            - { method: POST, name: postorganisationnodes, call: oac-organisation-nodes.postorganisationnodes, with: { body: rest.body } }
    - type: mcp
      namespace: oac-organisation-nodes-mcp
      port: 9090
      transport: http
      tools:
        - name: fintecture-create-organisation-node
          description: Create Organisation Node
          hints: { readOnly: false, destructive: false, idempotent: false }
          call: oac-organisation-nodes.postorganisationnodes
          with: { body: tools.body }
        - name: fintecture-get-organisation-tree
          description: Get Organisation Tree
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: oac-organisation-nodes.getorganisationtree
          with: { organisation_node_id: tools.organisation_node_id }
        - name: fintecture-get-organisation-companies
          description: Get Companies In Organisation
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: oac-organisation-nodes.getorganisationnodecompanies
          with: { organisation_node_id: tools.organisation_node_id }