curl -X POST "https://api.moorcheh.ai/v1/namespaces/demo-namespace/documents" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -d '{
    "documents": [
      {
        "id": "doc_001",
        "text": "Machine learning is a subset of artificial intelligence that enables computers to learn and improve from experience without being explicitly programmed.",
        "title": "Introduction to Machine Learning",
        "category": "education",
        "difficulty": "beginner",
        "author": "Dr. Smith"
      }
    ]
  }'

curl -X POST "https://api.moorcheh.ai/v1/namespaces/demo-namespace/documents" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -d '{
    "documents": [
      {
        "id": "doc_001",
        "text": "API authentication requires including your API key in the x-api-key header for all requests.",
        "title": "API Authentication Guide",
        "category": "security",
        "priority": "high"
      },
      {
        "id": "doc_002",
        "text": "Rate limiting protects our service by limiting the number of requests per hour. Premium users have higher limits.",
        "title": "Rate Limiting Policy",
        "category": "policy",
        "priority": "medium"
      }
    ]
  }'

{
  "status": "success",
  "message": "2 documents uploaded successfully to namespace 'technical-docs'",
  "upload_id": "upload_1234567890",
  "namespace_name": "technical-docs",
  "documents_processed": 2,
  "processing_status": "in_progress",
  "estimated_completion": "2024-01-15T10:35:00Z",
  "uploaded_documents": [
    {
      "id": "doc_001",
      "status": "processing",
      "character_count": 89
    },
    {
      "id": "doc_002",
      "status": "processing",
      "character_count": 112
    }
  ]
}

{
  "status": "partial_success",
  "message": "2 out of 3 documents uploaded successfully. 1 document failed validation.",
  "upload_id": "upload_1234567891",
  "namespace_name": "my-documents",
  "documents_processed": 2,
  "documents_failed": 1,
  "uploaded_documents": [
    {
      "id": "doc_001",
      "status": "processing",
      "character_count": 156
    },
    {
      "id": "doc_002",
      "status": "processing",
      "character_count": 203
    }
  ],
  "failed_documents": [
    {
      "id": "doc_003",
      "error": "Text content too short",
      "message": "Document text must be at least 10 characters long",
      "provided_length": 3
    }
  ]
}

{
  "status": "failure",
  "message": "Bad Request: Each document in 'documents' must have a non-empty 'id' (string or number)."
}

{
  "error": "Invalid request parameters",
  "message": "Documents array is required and must contain at least one document",
  "details": {
    "field": "documents",
    "requirement": "Array with minimum 1 document"
  }
}

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key. Please check your x-api-key header.",
  "timestamp": "2024-01-15T10:30:00Z"
}

{
  "error": "Forbidden",
  "message": "Document upload limit reached for your current tier. Upgrade your plan or delete unused documents.",
  "details": {
    "current_count": 9985,
    "tier_limit": 10000,
    "tier": "professional",
    "documents_attempted": 25
  }
}

{
  "error": "Namespace not found",
  "message": "No text namespace found with the name 'my-documents' in your account.",
  "namespace_name": "my-documents",
  "suggestion": "Create the namespace first or check the namespace name."
}

{
  "error": "Internal server error",
  "message": "An unexpected error occurred while uploading documents. Please try again later.",
  "timestamp": "2024-01-15T10:30:00Z",
  "request_id": "req_1234567890"
}