RESURGO :: DEVELOPER_DOCS
API Reference
Build on top of Resurgo with our REST API, webhooks, and integrations. 17+ endpoints available.
QUICKSTART
1. GENERATE_API_KEY
Go to Dashboard → Integrations → API Keys → Generate Key
2. MAKE_FIRST_REQUEST
curl https://resurgo.life/api/v1 \ -H "x-api-key: rsg_your_key_here"
3. RESPONSE
{
"version": "1.4.0",
"status": "operational",
"endpoints": {
"goals": "/api/v1/goals",
"habits": "/api/v1/habits",
"stats": "/api/v1/stats"
}
}4. CREATE_A_GOAL
curl -X POST https://resurgo.life/api/v1/goals \
-H "x-api-key: rsg_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"title": "Learn Spanish",
"category": "learning",
"timeline": "6 months",
"description": "Reach B1 level conversational fluency"
}'AUTHENTICATION
All API requests require authentication via API key. Pass your key in the request header:
x-api-key: rsg_your_api_key_here # or Authorization: Bearer rsg_your_api_key_here
Generate API keys from your Integrations dashboard. Keys start with rsg_ and are shown once upon generation.
SECURITY_NOTE
Never expose your API key in client-side code or public repositories. Use environment variables and server-side requests only.
CORE_ENDPOINTS
GET/api/v1API health check — returns version, status, and available endpoints
GET/api/v1/goalsList all goals for the authenticated user (supports pagination)
POST/api/v1/goalsCreate a new goal with title, category, timeline, and milestones
GET/api/v1/habitsList all habits with streak data (daily, weekly frequency)
POST/api/v1/habits/logLog a habit completion — updates streak and awards XP
GET/api/v1/statsGet productivity statistics: streaks, completion rates, XP, level
EXAMPLE_RESPONSE :: POST /api/v1/goals
{
"success": true,
"goal": {
"id": "g_abc123xyz",
"title": "Learn Spanish",
"category": "learning",
"progress": 0,
"milestones": [
{ "title": "Complete A1 basics", "target": "Month 1" },
{ "title": "Hold 5-min conversation", "target": "Month 3" },
{ "title": "Pass B1 test", "target": "Month 6" }
],
"createdAt": "2026-02-15T10:30:00Z",
"status": "active"
}
}AI_ENDPOINTS
POST/api/ai/chatSend a message to the AI coach — returns coaching response
POST/api/ai/suggestionsGet AI-powered suggestions for habits, tasks, or goals
POST/api/ai/decomposeDecompose a goal into milestones, tasks, and daily actions via AI
POST/api/coachInvoke a specific AI coach persona (Marcus, Aurora, Titan, etc.)
POST/api/chatbotKai chatbot — conversational AI for general productivity help
POST/api/chatbot/eventsStream chatbot events for real-time conversation updates
EXAMPLE :: POST /api/ai/chat
REQUEST_BODY
{
"message": "I keep procrastinating on my coding project",
"coach": "marcus",
"context": { "currentStreak": 5, "level": 12 }
}RESPONSE
{
"response": "Procrastination on a project you care about usually means the next step isn't clear enough. Break it into a 15-minute task. What's the smallest thing you could ship today?",
"coach": "marcus",
"actionItems": [
"Define one small deliverable for today",
"Set a 25-min focus session",
"Review progress tomorrow"
]
}INTEGRATION_ENDPOINTS
POST/api/telegram/webhookTelegram bot webhook — receives messages and commands
POST/api/webhooks/dodoDodo Payments webhook — processes payment events
POST/api/webhooks/clerk-billingClerk auth webhook — handles user events and billing sync
POST/api/vision-board/generateGenerate a vision board image from user goals
POST/api/partner-enginePartner engine — find accountability partners
POST/api/onboarding/detect-archetypeDetect user archetype from onboarding answers
WEBHOOKS
Resurgo supports outgoing webhooks to notify your systems when events occur. Configure webhooks in Dashboard → Integrations → Webhooks.
AVAILABLE_EVENTS
>
goal.created>
goal.completed>
goal.updated>
habit.logged>
habit.streak_milestone>
user.level_up>
user.achievement_unlocked>
session.focus_completed>
payment.succeeded>
payment.failedWEBHOOK_PAYLOAD_EXAMPLE
{
"event": "habit.logged",
"timestamp": "2026-02-15T08:00:00Z",
"data": {
"habitId": "h_xyz789",
"habitName": "Morning Meditation",
"streak": 21,
"xpAwarded": 25
},
"signature": "sha256=..."
}RATE_LIMITS
FREE
0 req/hr
No API access
PRO
100 req/hr
Standard rate
ENTERPRISE
Custom
Contact us
Rate limit headers are included in every response:
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-ResetERROR_CODES
200OK — Request succeeded
201Created — Resource created successfully
400Bad Request — Invalid parameters or missing fields
401Unauthorized — Missing or invalid API key
403Forbidden — Insufficient permissions for this action
404Not Found — Resource does not exist
429Rate Limited — Too many requests, try again later
500Internal Error — Something went wrong on our end
ERROR_RESPONSE_FORMAT
{
"error": true,
"code": 401,
"message": "Invalid API key. Check your x-api-key header.",
"docs": "https://resurgo.life/docs#auth"
}SDKs_&_LIBRARIES
JavaScript / Node.js
COMING SOONnpm install @resurgo/sdkPython
COMING SOONpip install resurgocURL
AVAILABLEWorks out of the boxTelegram Bot
BUILT-IN@ResurgoBot on Telegram