QAFlow Documentation

QAFlow exposes a REST API for every core content type, so you can build custom integrations, mobile clients or embeddable widgets on top of your community.

Authentication

All requests require a personal access token, generated from Account → Settings → API. Send it as a bearer token on every request:

• Authorization: Bearer YOUR_TOKEN

The base URL for every endpoint below is https://your-domain.com/api/v1.

Questions & Answers

• GET /questions — list questions, supports ?sort=, ?category= and ?tag= query parameters
• POST /questions — create a question
• GET /questions/{id} — fetch a single question with its answers
• POST /questions/{id}/answers — post an answer
• POST /answers/{id}/vote — upvote or downvote an answer, body: {"direction": "up"}

Content Types

The same pattern applies to every other enabled content type — /blogs, /forums, /jobs, /deals, /reviews, /news, /recipes and /downloads all support the equivalent GET (list), GET /{id} (show) and POST (create) operations. A disabled content type's endpoints return a 404.

Users & Gamification

• GET /users/{id} — public profile, level, reputation and earned badges
• GET /users/{id}/badges — full badge history
• GET /leaderboard — top contributors, supports ?period=daily|weekly|monthly|all

Search

• GET /search?q=your+query — searches across every enabled content type, results are grouped by type

Webhooks

Configure outbound webhooks from Admin → Settings → Webhooks. QAFlow fires the following events:

• question.created, answer.created, answer.accepted
• user.registered, user.leveled_up
• bounty.awarded, wallet.credited

Each payload includes the full resource plus an event field naming which one fired.

Rate Limits

API requests are limited to 60 requests per minute per token by default. This is configurable per plan from Admin → Settings → API. Responses include X-RateLimit-Limit and X-RateLimit-Remaining headers.

Key Configuration Options

• Admin → Settings → AI Providers — API keys for OpenAI, Anthropic, Google Gemini, Groq and Stability AI, plus which provider handles auto-answers, moderation and translation
• Admin → Settings → Payment Gateways — Stripe, PayPal, Razorpay and 2Checkout credentials for wallet top-ups, Pro plans, bounties and tipping
• Admin → Settings → Features — per-module toggles for every content type and AI capability