Oldmanism Surveys

Date range Channel

Completion funnel

Import historical responses

Import the Grapevine Download CSV export into this survey. Each response row is matched to a question & option by their text/label. The DB is backed up before import. Column mapping is confirmed against the real export.

CSV file

Question → column (one per answered question)

REST API for AI agents / scripts

Base URL: · Header: X-Api-Key: <DASHBOARD_API_KEY> (in .env on the VPS). In Admin the UI uses the session token automatically.

Method	Path	Description
GET	`/api/surveys`	List all surveys (nested questions/options)
GET	`/api/surveys/{id}`	One survey config
POST	`/api/surveys`	Create survey
PATCH	`/api/surveys/{id}`	Update config / questions
DELETE	`/api/surveys/{id}`	Delete survey + responses
GET	`/api/report/{id}?range=&channel=`	KPIs, funnel, per-answer revenue/AOV
POST	`/api/import/{id}`	`{rows:[…]}` bulk import responses

Public (checkout extension, extension session token):

GET	`/api/public/survey?surface=thank_you\|order_status`	Active survey config
POST	`/api/public/impression`	`{survey_id,order_id,surface}`
POST	`/api/public/response`	`{survey_id,order_id,answers,completed}` (revenue fetched server-side)