AITaskFlo Documentation
Automation. Intelligence. Scale.
Welcome to the complete AITaskFlo platform documentation. This guide covers everything from basic bot interactions to advanced enterprise features.
🤖 AI Bot Factory
4 specialized bots with memory, collaboration, and API integration capabilities.
🌐 15+ Free APIs
Weather, news, currency, utilities, and more - all integrated and ready to use.
🔒 Enterprise Security
JWT auth, rate limiting, input validation, and comprehensive security headers.
📊 Real-time Analytics
Live dashboards, usage tracking, and performance monitoring.
Quick Start
Get up and running with AITaskFlo in minutes.
1. Run Your First Bot
const response = await fetch('/run-bot', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-User-Id': 'your-user-id'
},
body: JSON.stringify({
botName: 'emailBot',
input: 'Create a welcome email for new users'
})
});
const data = await response.json();
console.log(data.logs);2. Try Team Collaboration
const response = await fetch('/team-run', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
input: 'Plan a product launch campaign'
})
});
// All 4 bots collaborate on your request!Authentication
AITaskFlo uses JWT tokens for secure admin access.
Admin Login
{
"email": "admin@taskflo.com",
"password": "your-password"
}Response:
{
"success": true,
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"user": {
"id": 1,
"email": "admin@taskflo.com",
"role": "super-admin"
}
}Using Tokens
// Include token in Authorization header
headers: {
'Authorization': 'Bearer your-jwt-token-here'
}AI Bots
📧 Email Bot Live
Creates professional emails with motivational quotes and learns from previous campaigns.
Features:
- Integrates inspirational quotes from API
- Remembers previous email styles
- Suggests improvements based on history
{
"botName": "emailBot",
"input": "Create a follow-up email for demo users"
}📋 Task Bot Live
Manages tasks with unique UUIDs and priority tracking.
Features:
- Generates unique task IDs
- Automatic priority assignment
- Persistent task storage
📊 Analytics Bot Live
Generates metrics with visual themes and engagement tracking.
Features:
- Random color themes for charts
- Performance metrics generation
- Trend analysis
🔍 Research Bot Live
Conducts live research using news APIs and multiple sources.
Features:
- Live news integration
- Source citations
- Cross-referenced research
🧑🤝🧑 Team Collaboration Live
All bots work together on complex projects with cross-bot communication.
// Example team response:
[
"🧑🤝🧑 AI Crew Assembly — Mission: Plan marketing campaign",
"[EmailBot] Crafting campaign emails with motivational elements",
"[TaskBot] Creating project timeline with task IDs",
"[AnalyticsBot] Setting up success metrics and KPIs",
"[ResearchBot] Finding market trends and competitor analysis",
"💬 Cross-bot collaboration:",
"💡 TaskBot: Analytics show this should be priority #1!",
"✅ Mission Complete: Strategy deployed successfully!"
]Free APIs
🌤️ Weather Data Live
Get current weather information for any city worldwide.
// Example: /api/weather/london
{
"success": true,
"data": {
"city": "London",
"temperature": 18.5,
"description": "partly cloudy",
"humidity": 65,
"windSpeed": 3.2,
"icon": "https://openweathermap.org/img/w/02d.png"
}
}📰 News Feed Live
Latest news by category from trusted sources.
Available Categories:
| Category | Description | Example |
|---|---|---|
| technology | Tech news and innovations | /api/news/technology |
| business | Business and finance | /api/news/business |
| science | Scientific discoveries | /api/news/science |
| general | General news (default) | /api/news/general |
💱 Currency Exchange Live
Real-time currency conversion rates.
// Example: /api/exchange/usd/eur/100
{
"success": true,
"data": {
"from": "USD",
"to": "EUR",
"rate": 0.85,
"amount": 100,
"convertedAmount": 85.00,
"date": "2024-01-15"
}
}🛠️ Utility APIs Live
Various utility endpoints for common tasks.
📱 QR Code Generator
POST /api/qr-code
{
"text": "https://aitaskflo.com",
"size": "300x300"
}🎲 UUID Generator
GET /api/uuid/{count}
// /api/uuid/3
{
"success": true,
"data": [
"550e8400-e29b-41d4-a716-446655440000",
"6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"6ba7b811-9dad-11d1-80b4-00c04fd430c8"
]
}🎨 Random Colors
GET /api/color/{count}
{
"success": true,
"data": {
"hex": "#ff5733",
"rgb": {"r": 255, "g": 87, "b": 51},
"name": "Color-1704067200-0"
}
}😂 Random Jokes
GET /api/joke
{
"setup": "Why don't scientists trust atoms?",
"punchline": "Because they make up everything!",
"type": "general"
}Analytics Dashboard
Monitor your AITaskFlo usage with real-time analytics.
{
"totalInteractions": 1247,
"totalTasks": 89,
"completedTasks": 67,
"activeUsers": 23,
"botUsage": {
"emailBot": {
"totalInteractions": 312,
"lastUsed": "2024-01-15T10:30:00Z"
},
"taskBot": {
"totalInteractions": 298,
"lastUsed": "2024-01-15T11:15:00Z"
}
},
"apiUsage": {
"weather": [
{
"endpoint": "/weather/london",
"timestamp": "2024-01-15T09:45:00Z",
"success": true
}
]
}
}Rate Limits
AITaskFlo implements intelligent rate limiting to ensure fair usage.
| Endpoint Type | Limit | Window | Headers |
|---|---|---|---|
| General | 100 requests | 15 minutes | X-RateLimit-Limit |
| API Endpoints | 20 requests | 1 minute | X-RateLimit-Remaining |
| Bot Interactions | 20 requests | 1 minute | X-RateLimit-Reset |
Error Handling
AITaskFlo uses standard HTTP status codes and provides detailed error messages.
Common Error Responses:
400 - Bad Request
{
"success": false,
"errors": [
{
"field": "botName",
"message": "Bot name is required"
}
]
}401 - Unauthorized
{
"error": "Access token required"
}429 - Rate Limit Exceeded
{
"error": "API rate limit exceeded"
}500 - Server Error
{
"success": false,
"error": "Internal server error"
}Security
AITaskFlo implements enterprise-grade security measures.
🔒 JWT Authentication
Secure token-based authentication with configurable expiration.
🛡️ Helmet.js Protection
Security headers including CSRF, XSS, and clickjacking protection.