Knowledge Base Sources

curl https://api.telzino.com/v1/knowledge-bases/11111111-1111-1111-1111-111111111111/sources \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": [
    {
      "id": "22222222-2222-2222-2222-222222222222",
      "knowledge_base_id": "11111111-1111-1111-1111-111111111111",
      "organization_id": "987fcdeb-51a2-3bc4-d567-890123456789",
      "name": "https://example.com/docs",
      "source_type": "url",
      "status": "active",
      "url": "https://example.com/docs",
      "chunk_count": 12,
      "last_synced_at": "2026-06-17T12:30:00Z",
      "created_at": "2026-06-17T12:00:00Z"
    }
  ]
}

curl -X POST https://api.telzino.com/v1/knowledge-bases/11111111-1111-1111-1111-111111111111/sources \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceType": "url",
    "url": "https://example.com/docs"
  }'

{
  "data": {
    "sourceId": "22222222-2222-2222-2222-222222222222",
    "jobId": "33333333-3333-3333-3333-333333333333"
  }
}

curl -X POST https://api.telzino.com/v1/knowledge-bases/11111111-1111-1111-1111-111111111111/sources \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceType": "file",
    "fileName": "guide.pdf",
    "fileMime": "application/pdf",
    "fileSize": 1048576,
    "contentHash": "9a0364b9e99bb480dd25e1f0284c8555"
  }'

curl -X PUT "PRESIGNED_URL_FROM_RESPONSE" \
  -H "Content-Type: application/pdf" \
  --data-binary "@guide.pdf"

{
  "data": {
    "presignedUrl": "https://s3.amazonaws.com/...",
    "fileKey": "rag/org/kb/source/original.pdf",
    "sourceId": "22222222-2222-2222-2222-222222222222",
    "jobId": "33333333-3333-3333-3333-333333333333"
  }
}

{
  "error": "duplicate_source",
  "error_description": "This file already exists in the knowledge base",
  "details": {
    "existingSource": {
      "id": "22222222-2222-2222-2222-222222222222",
      "name": "guide.pdf",
      "status": "active"
    }
  }
}