Knowledge

Knowledge sources for RAG

List knowledge sources

get

Returns a list of knowledge sources (RAG documents). Requires Power plan or higher.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Query parameters

pageintegerOptional

Page number for pagination

Responses

200

A list of knowledge sources

application/json

get

/v1/knowledge

HTTPcURLJavaScriptPython

GET /v1/knowledge HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

A list of knowledge sources

[
  {
    "id": 1,
    "name": "text",
    "description": "text",
    "source_type": "text",
    "indexing": {
      "chunks_indexed": 1,
      "total_chunks": 1,
      "was_limited": true,
      "indexed_at": "2026-02-04T17:21:46.957Z"
    },
    "created_at": "2026-02-04T17:21:46.957Z",
    "updated_at": "2026-02-04T17:21:46.957Z"
  }
]

Create a text knowledge source

post

Create a knowledge source from text content. For file uploads, use POST /v1/knowledge/upload.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

namestring · max: 200Required

descriptionstring · max: 500Optional

contentstring · max: 100000Required

The text content to index

Responses

201

Knowledge source created

application/json

post

/v1/knowledge

HTTPcURLJavaScriptPython

POST /v1/knowledge HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "name": "text",
  "description": "text",
  "content": "text"
}

201

Knowledge source created

{
  "id": 1,
  "name": "text",
  "description": "text",
  "source_type": "text",
  "indexing": {
    "chunks_indexed": 1,
    "total_chunks": 1,
    "was_limited": true,
    "indexed_at": "2026-02-04T17:21:46.957Z"
  },
  "created_at": "2026-02-04T17:21:46.957Z",
  "updated_at": "2026-02-04T17:21:46.957Z"
}

Request upload URL for file-based knowledge

post

Get a signed URL to upload a PDF or TXT file. After uploading, call POST /v1/knowledge/{id}/confirm to trigger processing. Maximum file size: 50MB.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

namestring · max: 200Required

descriptionstring · max: 500Optional

filenamestringRequired

content_typestring · enumRequiredPossible values:

Responses

201

Upload URL generated

application/json

post

/v1/knowledge/upload

HTTPcURLJavaScriptPython

POST /v1/knowledge/upload HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "name": "text",
  "description": "text",
  "filename": "text",
  "content_type": "application/pdf"
}

201

Upload URL generated

{
  "knowledge_id": 1,
  "upload_url": "text",
  "expires_at": "2026-02-04T17:21:46.957Z"
}