naftiko: 1.0.0-alpha2
info:
  label: Convai Chat History API — Chat History
  description: Convai Chat History — list character sessions and fetch full session transcripts. 2 operations.
  tags:
  - Convai
  - Chat History
  - Analytics
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    CONVAI_API_KEY: CONVAI_API_KEY
capability:
  consumes:
  - type: http
    namespace: chat-history-chat-history
    baseUri: https://api.convai.com
    description: Convai Chat History business surface.
    resources:
    - name: chat-history-sessions
      path: /character/chat-history/list-sessions
      operations:
      - name: listsessions
        method: POST
        description: Convai List Character Sessions
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: chat-history-session
      path: /character/chat-history/get-session
      operations:
      - name: getsession
        method: POST
        description: Convai Get Session Transcript
        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: chat-history-mcp
    port: 9090
    transport: http
    tools:
    - name: convai-list-sessions
      description: Convai List Character Sessions
      hints: { readOnly: true, idempotent: true }
      call: chat-history-chat-history.listsessions
      with: { body: tools.body }
    - name: convai-get-session
      description: Convai Get Session Transcript
      hints: { readOnly: true, idempotent: true }
      call: chat-history-chat-history.getsession
      with: { body: tools.body }