đ API Key Management
đĄ Enter your API key once to enable all endpoint calls below. The key is stored in your browser session for demonstration purposes.
Users
Manage user records and view onboarding progress.
-
GET /api/users List all users with metadata.
-
POST /api/users Create a new user by email.
-
POST /api/users/anonymous Create an anonymous user with a randomly generated email (user_MMDDHHMMSS@xxxx.com).
Survey questions
Explore the required demographic baseline questions and user progress.
-
GET /api/survey-questions/baseline-questions Retrieve all baseline questions and options.
-
GET /api/survey-questions/pending?user_id=<id> Return unanswered question IDs grouped into baseline, all respondents, and specific respondents.
-
GET /api/survey-questions/next?user_id=<id> Get the next prioritized unanswered question for a user (specific â baseline â general).
-
GET /api/survey-questions/<question_id> Retrieve the full question payload for a single question.
-
POST /api/survey-questions/lookup Submit a JSON body with
{ "question_id": <int> }to retrieve details.
Prediction prompts
Generate LLM-backed response rankings for outstanding survey questions.
Enter a respondent ID to load unanswered questions from /api/survey-questions/pending and run Template 1 predictions directly from this page.
Pending questions will appear here after loading a respondent.
Question generate
Produce predictive survey questions from arbitrary focus text using structured responses.
-
POST /api/question-generate Submit
{ "focus_text": "..." }to receive three diagnostic survey questions. -
POST /api/question-generate/upload Persist a question object with answer options into the database.
User responses
Record and maintain answers submitted by users.
-
POST /api/responses Submit
{"user_id", "question_id", "option_id"}to capture or update an answer. -
GET /api/users/<user_id>/responses Return every question, option list, and the userâs selected response.
Pinecone configuration
View the current Pinecone namespace used for vector store isolation.
-
GET /api/pinecone-details/current-namespace Retrieve the active namespace for Pinecone vector operations.
System health
Monitor service readiness and infrastructure seeding.
-
GET /health Basic liveness check.