Skip to main content

Content Organization

Hierarchical Structure

Organize content in a logical hierarchy:
Knowledge Base
├── Product Information
│   ├── Features
│   ├── Pricing
│   └── Specifications
├── Customer Support
│   ├── FAQs
│   ├── Troubleshooting
│   └── How-to Guides
└── Company Policies
    ├── Terms of Service
    ├── Privacy Policy
    └── Return Policy

Tagging System

Use tags to create cross-cutting relationships:
{
  "document_id": "doc_123",
  "title": "Setting up Email Integration",
  "category": "support",
  "tags": ["email", "integration", "setup", "configuration"],
  "priority": "medium"
}

Content Lifecycle Management

Content Updates

Keep your knowledge base current with regular updates:
cURL
curl --request PUT \
  --url https://api.threetone.com/v1/voiceai/knowledge-base/documents/{document_id} \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "content": "Updated content with latest information...",
    "last_updated": "2024-01-15T10:30:00Z"
  }'

Version Control

Track document versions and changes:
{
  "document_id": "doc_123",
  "version": "2.1",
  "change_log": [
    {
      "version": "2.1",
      "date": "2024-01-15",
      "changes": "Updated pricing information"
    },
    {
      "version": "2.0",
      "date": "2024-01-01",
      "changes": "Major content restructure"
    }
  ]
}

Content Archival

Archive outdated content while maintaining history:
cURL
curl --request POST \
  --url https://api.threetone.com/v1/voiceai/knowledge-base/documents/{document_id}/archive \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "archive_reason": "Content outdated",
    "replacement_document": "doc_456"
  }'

Search and Discovery

Search across your knowledge base:
cURL
curl --request GET \
  --url 'https://api.threetone.com/v1/voiceai/knowledge-base/search?query=email+setup&category=support' \
  --header 'x-api-key: YOUR_API_KEY'

Advanced Filtering

Use advanced filters to find specific content:
cURL
curl --request GET \
  --url 'https://api.threetone.com/v1/voiceai/knowledge-base/documents?category=support&tags=email,setup&priority=high' \
  --header 'x-api-key: YOUR_API_KEY'

Content Quality Management

Quality Metrics

Monitor content quality with key metrics:
  • Usage Frequency: How often content is accessed
  • User Satisfaction: Feedback on content helpfulness
  • Accuracy Score: Content accuracy validation
  • Freshness: How recently content was updated

Content Validation

Implement content validation workflows:
{
  "validation_config": {
    "spell_check": true,
    "grammar_check": true,
    "fact_verification": true,
    "link_validation": true,
    "content_freshness_check": true
  }
}

Performance Analytics

Track content performance:
cURL
curl --request GET \
  --url https://api.threetone.com/v1/voiceai/knowledge-base/analytics \
  --header 'x-api-key: YOUR_API_KEY'

Bulk Operations

Bulk Upload

Upload multiple documents at once:
cURL
curl --request POST \
  --url https://api.threetone.com/v1/voiceai/knowledge-base/bulk-upload \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: multipart/form-data' \
  --form '[email protected]' \
  --form '[email protected]' \
  --form 'category=support'

Bulk Updates

Update multiple documents with batch operations:
cURL
curl --request PUT \
  --url https://api.threetone.com/v1/voiceai/knowledge-base/bulk-update \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "updates": [
      {
        "document_id": "doc_123",
        "category": "updated_category"
      },
      {
        "document_id": "doc_456",
        "tags": ["new_tag", "updated"]
      }
    ]
  }'

Integration Patterns

Automated Content Sync

Set up automated synchronization with external systems:
{
  "sync_config": {
    "source": "confluence",
    "endpoint": "https://your-confluence.com/api",
    "schedule": "daily",
    "categories": ["support", "product_info"]
  }
}

Webhook Notifications

Receive notifications for content changes:
{
  "webhook_url": "https://your-api.com/webhooks/content-updated",
  "events": ["document_created", "document_updated", "document_deleted"]
}

Best Practices

Content Maintenance

  • Regular content audits (monthly/quarterly)
  • Automated freshness checks
  • User feedback integration
  • Performance monitoring and optimization

Organization Strategy

  • Consistent categorization scheme
  • Clear naming conventions
  • Logical content hierarchy
  • Cross-referencing related content

Quality Assurance

  • Content review workflows
  • Accuracy validation processes
  • Regular updates and maintenance
  • User feedback incorporation

Next Steps