API Reference
Base URL
https://tabularpro.com/api
All endpoints are relative to this base URL.
Authentication
Include your API key in every request:
curl -H "X-API-Key: tp_your_key_here" \
https://tabularpro.com/api/surveys
See Authentication for details.
Response Format
All responses return JSON with this structure:
// Success
{ "success": 1, "data": { ... } }
// Success with list
{ "success": 1, "data": [ ... ] }
// Error
{ "error": 1, "message": "Error description" }
Deletions return 204 No Content with an empty body.
Workspace Context
Most data endpoints require a workspace context. Pass workspace_id as a query parameter:
GET /api/surveys?workspace_id=1
Content Type
All POST/PUT/PATCH requests must include:
Content-Type: application/json
Endpoints by Category
Core Data
| Category | Description | Reference |
|---|---|---|
| Surveys | Survey CRUD, publishing, import/export | GET/POST /surveys |
| Questions & Pages | Survey structure, question types, options | GET/POST /surveys/:id/questions |
| Responses | Response data, transformations, weighting, export | GET/POST /responses/:surveyId/* |
Analysis & AI
| Category | Description | Reference |
|---|---|---|
| AI Analysis | Sentiment, themes, classification, insights | POST /responses/:id/ai/* |
Deliverables
| Category | Description | Reference |
|---|---|---|
| Dashboards | Dashboard builder, charts, sharing | GET/POST /dashboards |
| Reports | Report builder, slides, PDF/PPTX export | GET/POST /reports |
Field Operations
| Category | Description | Reference |
|---|---|---|
| Field | Waves, links, invitations, quotas | GET/POST /surveys/waves |
Organization
| Category | Description | Reference |
|---|---|---|
| Users | User management, groups, permissions | GET/POST /users |
| Workspaces | Workspace CRUD, members | GET/POST /workspaces |
System
| Category | Description | Reference |
|---|---|---|
| Errors & Limits | Error codes, rate limits | — |
| MCP Server | AI agent integration | — |