naftiko: 1.0.0-alpha2
info:
  label: Convai Knowledge Bank API — Knowledge Bank
  description: 'Convai Knowledge Bank — RAG document management for Convai characters. 4 operations. Lead
    operation: Convai Upload Knowledge Bank Document.'
  tags:
  - Convai
  - Knowledge Bank
  - RAG
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    CONVAI_API_KEY: CONVAI_API_KEY
capability:
  consumes:
  - type: http
    namespace: knowledge-bank-knowledge-bank
    baseUri: https://api.convai.com
    description: Convai Knowledge Bank API business surface.
    resources:
    - name: kb-upload
      path: /character/knowledge-bank/upload
      operations:
      - name: uploadknowledgebank
        method: POST
        description: Convai Upload Knowledge Bank Document
        outputRawFormat: json
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: kb-update
      path: /character/knowledge-bank/update
      operations:
      - name: updateknowledgebank
        method: POST
        description: Convai Update Knowledge Bank Document
        outputRawFormat: json
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: kb-list
      path: /character/knowledge-bank/list
      operations:
      - name: listknowledgebank
        method: POST
        description: Convai List Knowledge Bank Documents
        outputRawFormat: json
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: kb-delete
      path: /character/knowledge-bank/delete
      operations:
      - name: deleteknowledgebank
        method: POST
        description: Convai Delete Knowledge Bank Document
        outputRawFormat: json
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    authentication:
      type: apikey
      key: CONVAI-API-KEY
      value: '{{env.CONVAI_API_KEY}}'
      placement: header
  exposes:
  - type: mcp
    namespace: knowledge-bank-mcp
    port: 9090
    transport: http
    description: MCP adapter for Convai Knowledge Bank.
    tools:
    - name: convai-upload-knowledge-bank
      description: Convai Upload Knowledge Bank Document
      call: knowledge-bank-knowledge-bank.uploadknowledgebank
      with:
        body: tools.body
    - name: convai-update-knowledge-bank
      description: Convai Update Knowledge Bank Document
      call: knowledge-bank-knowledge-bank.updateknowledgebank
      with:
        body: tools.body
    - name: convai-list-knowledge-bank
      description: Convai List Knowledge Bank Documents
      call: knowledge-bank-knowledge-bank.listknowledgebank
      with:
        body: tools.body
    - name: convai-delete-knowledge-bank
      description: Convai Delete Knowledge Bank Document
      hints:
        destructive: true
        idempotent: true
      call: knowledge-bank-knowledge-bank.deleteknowledgebank
      with:
        body: tools.body