Snakk AI - Voice Agent Platform API
  1. Knowledge Base
Snakk AI - Voice Agent Platform API
  • System
    • Simple health check
      GET
    • Detailed health check with dependency status
      GET
  • Tenants
    • Create new tenant (signup)
      POST
  • Agents
    • List all agents for tenant
      GET
    • Create new agent
      POST
    • Get agent details
      GET
    • Delete agent
      DELETE
    • Duplicate an agent
      POST
  • Tools
    • List tools/webhooks for agent
      GET
    • Add tool/webhook to agent
      POST
  • Calls
    • Start outbound call from database agent
      POST
    • Start outbound call with ad-hoc agent config (JSON)
      POST
    • List call history
      GET
    • Get call details
      GET
    • Diagnose recording issues
      GET
    • Call statistics
      GET
    • Fix recording data
      POST
  • Phone Numbers
    • List your phone numbers
      GET
    • Available numbers to claim
      GET
    • Claim a number from pool
      POST
    • Assign number to agent
      POST
    • Unassign number from agent
      POST
    • Release number (return to pool)
      POST
  • Statistics
    • Dashboard overview
    • Daily usage statistics
    • Monthly usage statistics
  • Subscription
    • Current subscription
    • Available plans
    • Request plan upgrade
  • Web Access
    • Generate web widget token
  • AI Tools
    • AI Prompt Generator
  • Account
    • Your account info
    • Regenerate API key
  • Platform Admin
    • Platform-wide overview (admin only)
  • Knowledge Base
    • List knowledge base files
      GET
    • Upload document to knowledge base
      POST
    • Delete knowledge base file
      DELETE
  • Chat Widget
    • Get chat widget config
    • Start chat session
    • Send chat message
    • Close chat session
    • List chat sessions
    • Get chat session details
    • Chat statistics
    • Get chat widget configuration
    • Update chat widget configuration
    • Close inactive sessions
    • Upload chat avatar/logo
    • Delete chat avatar/logo
    • Poll session status for human handoff
    • Poll session status (POST to avoid caching)
    • Get chat history
  • Version History
    • List agent version history
    • Get specific version details
    • Compare two versions
    • Restore agent to version
  • Workflows
    • List all workflows
    • Create workflow
    • Get workflow
    • Update workflow
    • Delete workflow
    • Publish workflow
    • Get version history
    • Rollback to version
    • Assign workflow to agent
    • Remove workflow from agent
  • Chat Operator
    • Get operator statistics
    • Get escalated chat queue
    • Get operator's active chats
    • Claim a chat from queue
    • Release a chat
    • Send message as operator
    • Update operator online status
    • Get contact requests
    • Update contact request
    • Create contact request
    • Subscribe to operator events (SSE)
    • Get all messages for a session
    • Update customer info for session
  • Chat Verification
    • Check if agent has protected tools
    • Initiate identity verification
    • Check verification status
  • Tool Logs
    • List tool call logs
    • Get single tool log
    • Get tool usage statistics
  • Schemas
    • Tenant
    • Agent
    • Call
    • ToolLog
    • AgentTool
  1. Knowledge Base

Upload document to knowledge base

POST
/api/knowledge-base/agents/{agentId}/files
Upload PDF, DOCX, or TXT file. Text is extracted and chunked for RAG.

Request

Authorization
API Key
Add parameter in header
X-API-Key
Example:
X-API-Key: ********************
or
Path Params

Body Params multipart/form-data

Responses

🟢201
File uploaded and processing started
This response does not have a body.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://snakk-backend-production.up.railway.app/api/knowledge-base/agents//files' \
--header 'X-API-Key: <api-key>' \
--form 'file=@""'
Modified at 2025-12-17 20:24:06
Previous
List knowledge base files
Next
Delete knowledge base file
Built with