Kit For AI

Kit For AI Knowledge Bases API

The Knowledge Bases API from Kit For AI — 4 operation(s) for knowledge bases.

GitHub OpenAPI

Operations 6

GET /api/v1/knowledge-bases List knowledge bases #
POST /api/v1/knowledge-bases Create a knowledge base #
GET /api/v1/knowledge-bases/{id} Read a knowledge base — all its docs as one Markdown document #
DELETE /api/v1/knowledge-bases/{id} Delete a knowledge base #
POST /api/v1/knowledge-bases/{id}/documents Attach a converted document to a knowledge base #
POST /api/v1/knowledge-bases/{id}/search Search a knowledge base #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/kitforai/refs/heads/main/openapi/kitforai-knowledge-bases-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/kitforai:kitforai-knowledge-bases-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

kitforai-knowledge-bases-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Kit for AI — API Playground Knowledge Bases API
  version: 1.0.0
  description: Welcome to the **Kit for AI** API playground.
  contact:
    name: Kit for AI
    url: https://kitforai.com
servers:
- url: https://kitforai.com
security:
- apiKey: []
tags:
- name: Knowledge Bases
paths:
  /api/v1/knowledge-bases:
    get:
      summary: List knowledge bases
      description: List the caller's knowledge bases, optionally filtered by `kind`.
      responses:
        '200':
          description: Knowledge bases
        '401':
          description: Missing or invalid API key
      tags:
      - Knowledge Bases
      operationId: getApiV1KnowledgeBases
      x-operation-id-source: derived
    post:
      summary: Create a knowledge base
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              properties:
                name:
                  type: string
                kind:
                  type: string
                  enum:
                  - knowledge_base
                  default: knowledge_base
                description:
                  type: string
      responses:
        '201':
          description: Created
        '401':
          description: Missing or invalid API key
      tags:
      - Knowledge Bases
      operationId: postApiV1KnowledgeBases
      x-operation-id-source: derived
  /api/v1/knowledge-bases/{id}:
    get:
      summary: Read a knowledge base — all its docs as one Markdown document
      description: Returns the knowledge base's documents joined into a single `content` field — the whole category, ready for your model.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Knowledge base content
        '404':
          description: Not found
      tags:
      - Knowledge Bases
      operationId: getApiV1KnowledgeBasesById
      x-operation-id-source: derived
    delete:
      summary: Delete a knowledge base
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Deleted
      tags:
      - Knowledge Bases
      operationId: deleteApiV1KnowledgeBasesById
      x-operation-id-source: derived
  /api/v1/knowledge-bases/{id}/documents:
    post:
      summary: Attach a converted document to a knowledge base
      description: Attach a conversion (from `POST /api/v1/convert`) to a knowledge base so it can be searched and cited. This is the second step of the ingest → attach flow.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - conversionId
              properties:
                conversionId:
                  type: string
                  description: The id returned by /api/v1/convert
      responses:
        '201':
          description: Attached
        '404':
          description: Knowledge base or document not found
      tags:
      - Knowledge Bases
      operationId: postApiV1KnowledgeBasesByIdDocuments
      x-operation-id-source: derived
  /api/v1/knowledge-bases/{id}/search:
    post:
      summary: Search a knowledge base
      description: Hybrid semantic + keyword search over a knowledge base's attached (non-excluded) documents. Returns the most relevant passages with their source document and a relevance score — the retrieval half of a RAG answer.
      operationId: searchKnowledgeBase
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
                  description: The question or search text
                k:
                  type: integer
                  default: 6
                  description: Max passages to return
      responses:
        '200':
          description: Ranked passages
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    document:
                      type: string
                      description: Source document name
                    content:
                      type: string
                      description: The matching passage
                    score:
                      type: number
                      description: Relevance score
                    documentId:
                      type:
                      - string
                      - 'null'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Knowledge base not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Knowledge Bases
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            endUserMessage:
              type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key