naftiko: 1.0.0-alpha2
info:
  label: Fintecture OAC API — Users
  description: 'Fintecture OAC API — Users. 4 operations. Lead operation: Create User.'
  tags: [Fintecture, OAC, Users, Memberships, 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-users
      baseUri: https://api.fintecture.com
      description: Beta Console user management.
      resources:
        - name: v1-users
          path: /v1/users
          operations:
            - name: postusers
              method: POST
              description: Create User
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: '$.' }]
              inputParameters: [{ name: body, in: body, required: true }]
        - name: v1-user
          path: /v1/users/{user_id}
          operations:
            - name: getuserbyid
              method: GET
              description: Get User
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: '$.' }]
              inputParameters: [{ name: user_id, in: path, required: true }]
            - name: patchuserbyid
              method: PATCH
              description: Update User
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: '$.' }]
              inputParameters:
                - { name: user_id, in: path, required: true }
                - { name: body, in: body, required: true }
            - name: deleteuserbyid
              method: DELETE
              description: Delete User
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: '$.' }]
              inputParameters: [{ name: user_id, in: path, required: true }]
      authentication:
        type: bearer
        value: '{{env.FINTECTURE_OAC_TOKEN}}'
        placement: header
  exposes:
    - type: rest
      namespace: oac-users-rest
      port: 8080
      resources:
        - path: /v1/v1/users
          name: v1-users
          operations:
            - { method: POST, name: postusers, call: oac-users.postusers, with: { body: rest.body } }
    - type: mcp
      namespace: oac-users-mcp
      port: 9090
      transport: http
      tools:
        - name: fintecture-create-user
          description: Create User
          hints: { readOnly: false, destructive: false, idempotent: false }
          call: oac-users.postusers
          with: { body: tools.body }
        - name: fintecture-get-user
          description: Get User
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: oac-users.getuserbyid
          with: { user_id: tools.user_id }
        - name: fintecture-delete-user
          description: Delete User
          hints: { readOnly: false, destructive: true, idempotent: true }
          call: oac-users.deleteuserbyid
          with: { user_id: tools.user_id }