v1

latestOpenAPI 3.0.1MIT2026-07-26104203277.0 KB

Create new knowledge base items.

post/v1/voice-agents/knowledge-base

Request body

Example request

{
  "items": [
    {
      "itemName": "Product Documentation",
      "itemUrl": "https://example.com/document.pdf",
      "itemUrls": [
        "https://example.com/document.pdf"
      ],
      "content": "This is the content of the knowledge base item...",
      "type": "TEXT"
    }
  ]
}

Response

Successful response

successboolean
messagestring

Example response

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "userId": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "itemName": "Product Documentation",
    "fileSize": "2.5MB",
    "type": "TEXT",
    "status": "PROCESSED",
    "failureReason": "File format not supported",
    "content": "This is the content of the knowledge base item...",
    "itemUrl": "https://example.com/document.pdf",
    "itemUrls": [
      "https://example.com/document.pdf"
    ],
    "wordsNumber": 1298,
    "createdAt": "2024-01-15T10:30:00Z",
    "isActive": true,
    "used": true
  }
}