@l4yercak3/cli 1.3.1 → 2.0.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (357) hide show
  1. package/README.md +10 -220
  2. package/dist/api/client.d.ts +12 -0
  3. package/dist/api/client.d.ts.map +1 -0
  4. package/dist/api/client.js +37 -0
  5. package/dist/api/client.js.map +1 -0
  6. package/dist/api/platform.d.ts +161 -0
  7. package/dist/api/platform.d.ts.map +1 -0
  8. package/dist/api/platform.js +70 -0
  9. package/dist/api/platform.js.map +1 -0
  10. package/dist/bin/sevenlayers.d.ts +3 -0
  11. package/dist/bin/sevenlayers.d.ts.map +1 -0
  12. package/dist/bin/sevenlayers.js +198 -0
  13. package/dist/bin/sevenlayers.js.map +1 -0
  14. package/dist/commands/agent/catalog.d.ts +5 -0
  15. package/dist/commands/agent/catalog.d.ts.map +1 -0
  16. package/dist/commands/agent/catalog.js +142 -0
  17. package/dist/commands/agent/catalog.js.map +1 -0
  18. package/dist/commands/agent/drift.d.ts +5 -0
  19. package/dist/commands/agent/drift.d.ts.map +1 -0
  20. package/dist/commands/agent/drift.js +113 -0
  21. package/dist/commands/agent/drift.js.map +1 -0
  22. package/dist/commands/agent/init.d.ts +5 -0
  23. package/dist/commands/agent/init.d.ts.map +1 -0
  24. package/dist/commands/agent/init.js +75 -0
  25. package/dist/commands/agent/init.js.map +1 -0
  26. package/dist/commands/agent/permissions.d.ts +5 -0
  27. package/dist/commands/agent/permissions.d.ts.map +1 -0
  28. package/dist/commands/agent/permissions.js +88 -0
  29. package/dist/commands/agent/permissions.js.map +1 -0
  30. package/dist/commands/agent/runner.d.ts +14 -0
  31. package/dist/commands/agent/runner.d.ts.map +1 -0
  32. package/dist/commands/agent/runner.js +59 -0
  33. package/dist/commands/agent/runner.js.map +1 -0
  34. package/dist/commands/agent/shared.d.ts +13 -0
  35. package/dist/commands/agent/shared.d.ts.map +1 -0
  36. package/dist/commands/agent/shared.js +31 -0
  37. package/dist/commands/agent/shared.js.map +1 -0
  38. package/dist/commands/agent/template.d.ts +5 -0
  39. package/dist/commands/agent/template.d.ts.map +1 -0
  40. package/dist/commands/agent/template.js +104 -0
  41. package/dist/commands/agent/template.js.map +1 -0
  42. package/dist/commands/app/connect.d.ts +7 -0
  43. package/dist/commands/app/connect.d.ts.map +1 -0
  44. package/dist/commands/app/connect.js +12 -0
  45. package/dist/commands/app/connect.js.map +1 -0
  46. package/dist/commands/app/init.d.ts +7 -0
  47. package/dist/commands/app/init.d.ts.map +1 -0
  48. package/dist/commands/app/init.js +12 -0
  49. package/dist/commands/app/init.js.map +1 -0
  50. package/dist/commands/app/link.d.ts +3 -0
  51. package/dist/commands/app/link.d.ts.map +1 -0
  52. package/dist/commands/app/link.js +92 -0
  53. package/dist/commands/app/link.js.map +1 -0
  54. package/dist/commands/app/pages.d.ts +15 -0
  55. package/dist/commands/app/pages.d.ts.map +1 -0
  56. package/dist/commands/app/pages.js +180 -0
  57. package/dist/commands/app/pages.js.map +1 -0
  58. package/dist/commands/app/register.d.ts +3 -0
  59. package/dist/commands/app/register.d.ts.map +1 -0
  60. package/dist/commands/app/register.js +120 -0
  61. package/dist/commands/app/register.js.map +1 -0
  62. package/dist/commands/app/remote.d.ts +14 -0
  63. package/dist/commands/app/remote.d.ts.map +1 -0
  64. package/dist/commands/app/remote.js +44 -0
  65. package/dist/commands/app/remote.js.map +1 -0
  66. package/dist/commands/app/setup.d.ts +3 -0
  67. package/dist/commands/app/setup.d.ts.map +1 -0
  68. package/dist/commands/app/setup.js +299 -0
  69. package/dist/commands/app/setup.js.map +1 -0
  70. package/dist/commands/app/shared.d.ts +9 -0
  71. package/dist/commands/app/shared.d.ts.map +1 -0
  72. package/dist/commands/app/shared.js +122 -0
  73. package/dist/commands/app/shared.js.map +1 -0
  74. package/dist/commands/app/sync.d.ts +7 -0
  75. package/dist/commands/app/sync.d.ts.map +1 -0
  76. package/dist/commands/app/sync.js +107 -0
  77. package/dist/commands/app/sync.js.map +1 -0
  78. package/dist/commands/booking/check.d.ts +3 -0
  79. package/dist/commands/booking/check.d.ts.map +1 -0
  80. package/dist/commands/booking/check.js +68 -0
  81. package/dist/commands/booking/check.js.map +1 -0
  82. package/dist/commands/booking/setup.d.ts +3 -0
  83. package/dist/commands/booking/setup.d.ts.map +1 -0
  84. package/dist/commands/booking/setup.js +95 -0
  85. package/dist/commands/booking/setup.js.map +1 -0
  86. package/dist/commands/booking/shared.d.ts +31 -0
  87. package/dist/commands/booking/shared.d.ts.map +1 -0
  88. package/dist/commands/booking/shared.js +112 -0
  89. package/dist/commands/booking/shared.js.map +1 -0
  90. package/dist/commands/booking/smoke.d.ts +3 -0
  91. package/dist/commands/booking/smoke.d.ts.map +1 -0
  92. package/dist/commands/booking/smoke.js +101 -0
  93. package/dist/commands/booking/smoke.js.map +1 -0
  94. package/dist/commands/cms/bind.d.ts +3 -0
  95. package/dist/commands/cms/bind.d.ts.map +1 -0
  96. package/dist/commands/cms/bind.js +212 -0
  97. package/dist/commands/cms/bind.js.map +1 -0
  98. package/dist/commands/cms/content.d.ts +40 -0
  99. package/dist/commands/cms/content.d.ts.map +1 -0
  100. package/dist/commands/cms/content.js +169 -0
  101. package/dist/commands/cms/content.js.map +1 -0
  102. package/dist/commands/cms/doctor.d.ts +3 -0
  103. package/dist/commands/cms/doctor.d.ts.map +1 -0
  104. package/dist/commands/cms/doctor.js +69 -0
  105. package/dist/commands/cms/doctor.js.map +1 -0
  106. package/dist/commands/cms/migrate.d.ts +3 -0
  107. package/dist/commands/cms/migrate.d.ts.map +1 -0
  108. package/dist/commands/cms/migrate.js +78 -0
  109. package/dist/commands/cms/migrate.js.map +1 -0
  110. package/dist/commands/cms/registry.d.ts +3 -0
  111. package/dist/commands/cms/registry.d.ts.map +1 -0
  112. package/dist/commands/cms/registry.js +161 -0
  113. package/dist/commands/cms/registry.js.map +1 -0
  114. package/dist/commands/cms/seed.d.ts +3 -0
  115. package/dist/commands/cms/seed.d.ts.map +1 -0
  116. package/dist/commands/cms/seed.js +102 -0
  117. package/dist/commands/cms/seed.js.map +1 -0
  118. package/dist/commands/cms/shared.d.ts +22 -0
  119. package/dist/commands/cms/shared.d.ts.map +1 -0
  120. package/dist/commands/cms/shared.js +82 -0
  121. package/dist/commands/cms/shared.js.map +1 -0
  122. package/dist/commands/doctor/target.d.ts +3 -0
  123. package/dist/commands/doctor/target.d.ts.map +1 -0
  124. package/dist/commands/doctor/target.js +46 -0
  125. package/dist/commands/doctor/target.js.map +1 -0
  126. package/dist/commands/env/list.d.ts +3 -0
  127. package/dist/commands/env/list.d.ts.map +1 -0
  128. package/dist/commands/env/list.js +28 -0
  129. package/dist/commands/env/list.js.map +1 -0
  130. package/dist/commands/env/set.d.ts +3 -0
  131. package/dist/commands/env/set.d.ts.map +1 -0
  132. package/dist/commands/env/set.js +36 -0
  133. package/dist/commands/env/set.js.map +1 -0
  134. package/dist/commands/env/use.d.ts +3 -0
  135. package/dist/commands/env/use.d.ts.map +1 -0
  136. package/dist/commands/env/use.js +15 -0
  137. package/dist/commands/env/use.js.map +1 -0
  138. package/dist/commands/legacy/connect.d.ts +3 -0
  139. package/dist/commands/legacy/connect.d.ts.map +1 -0
  140. package/dist/commands/legacy/connect.js +8 -0
  141. package/dist/commands/legacy/connect.js.map +1 -0
  142. package/dist/commands/legacy/pages.d.ts +3 -0
  143. package/dist/commands/legacy/pages.d.ts.map +1 -0
  144. package/dist/commands/legacy/pages.js +16 -0
  145. package/dist/commands/legacy/pages.js.map +1 -0
  146. package/dist/commands/legacy/spread.d.ts +3 -0
  147. package/dist/commands/legacy/spread.d.ts.map +1 -0
  148. package/dist/commands/legacy/spread.js +8 -0
  149. package/dist/commands/legacy/spread.js.map +1 -0
  150. package/dist/commands/legacy/sync.d.ts +3 -0
  151. package/dist/commands/legacy/sync.d.ts.map +1 -0
  152. package/dist/commands/legacy/sync.js +8 -0
  153. package/dist/commands/legacy/sync.js.map +1 -0
  154. package/dist/config/env-diff.d.ts +10 -0
  155. package/dist/config/env-diff.d.ts.map +1 -0
  156. package/dist/config/env-diff.js +24 -0
  157. package/dist/config/env-diff.js.map +1 -0
  158. package/dist/config/env-parser.d.ts +20 -0
  159. package/dist/config/env-parser.d.ts.map +1 -0
  160. package/dist/config/env-parser.js +70 -0
  161. package/dist/config/env-parser.js.map +1 -0
  162. package/dist/config/env-writer.d.ts +22 -0
  163. package/dist/config/env-writer.d.ts.map +1 -0
  164. package/dist/config/env-writer.js +172 -0
  165. package/dist/config/env-writer.js.map +1 -0
  166. package/dist/config/profile-store.d.ts +29 -0
  167. package/dist/config/profile-store.d.ts.map +1 -0
  168. package/dist/config/profile-store.js +257 -0
  169. package/dist/config/profile-store.js.map +1 -0
  170. package/dist/core/args.d.ts +11 -0
  171. package/dist/core/args.d.ts.map +1 -0
  172. package/dist/core/args.js +106 -0
  173. package/dist/core/args.js.map +1 -0
  174. package/dist/core/colors.d.ts +6 -0
  175. package/dist/core/colors.d.ts.map +1 -0
  176. package/dist/core/colors.js +29 -0
  177. package/dist/core/colors.js.map +1 -0
  178. package/dist/safety/target-guard.d.ts +16 -0
  179. package/dist/safety/target-guard.d.ts.map +1 -0
  180. package/dist/safety/target-guard.js +55 -0
  181. package/dist/safety/target-guard.js.map +1 -0
  182. package/dist/testing/booking-smoke.d.ts +17 -0
  183. package/dist/testing/booking-smoke.d.ts.map +1 -0
  184. package/dist/testing/booking-smoke.js +43 -0
  185. package/dist/testing/booking-smoke.js.map +1 -0
  186. package/dist/tests/agent-commands.test.d.ts +2 -0
  187. package/dist/tests/agent-commands.test.d.ts.map +1 -0
  188. package/dist/tests/agent-commands.test.js +180 -0
  189. package/dist/tests/agent-commands.test.js.map +1 -0
  190. package/dist/tests/agent-governance.test.d.ts +2 -0
  191. package/dist/tests/agent-governance.test.d.ts.map +1 -0
  192. package/dist/tests/agent-governance.test.js +233 -0
  193. package/dist/tests/agent-governance.test.js.map +1 -0
  194. package/dist/tests/app-commands.test.d.ts +2 -0
  195. package/dist/tests/app-commands.test.d.ts.map +1 -0
  196. package/dist/tests/app-commands.test.js +462 -0
  197. package/dist/tests/app-commands.test.js.map +1 -0
  198. package/dist/tests/booking-commands.test.d.ts +2 -0
  199. package/dist/tests/booking-commands.test.d.ts.map +1 -0
  200. package/dist/tests/booking-commands.test.js +204 -0
  201. package/dist/tests/booking-commands.test.js.map +1 -0
  202. package/dist/tests/booking-smoke.test.d.ts +2 -0
  203. package/dist/tests/booking-smoke.test.d.ts.map +1 -0
  204. package/dist/tests/booking-smoke.test.js +183 -0
  205. package/dist/tests/booking-smoke.test.js.map +1 -0
  206. package/dist/tests/cms-commands.test.d.ts +2 -0
  207. package/dist/tests/cms-commands.test.d.ts.map +1 -0
  208. package/dist/tests/cms-commands.test.js +254 -0
  209. package/dist/tests/cms-commands.test.js.map +1 -0
  210. package/dist/tests/cms-ops.test.d.ts +2 -0
  211. package/dist/tests/cms-ops.test.d.ts.map +1 -0
  212. package/dist/tests/cms-ops.test.js +125 -0
  213. package/dist/tests/cms-ops.test.js.map +1 -0
  214. package/dist/tests/env-writer.test.d.ts +2 -0
  215. package/dist/tests/env-writer.test.d.ts.map +1 -0
  216. package/dist/tests/env-writer.test.js +90 -0
  217. package/dist/tests/env-writer.test.js.map +1 -0
  218. package/dist/tests/profile-store.test.d.ts +2 -0
  219. package/dist/tests/profile-store.test.d.ts.map +1 -0
  220. package/dist/tests/profile-store.test.js +88 -0
  221. package/dist/tests/profile-store.test.js.map +1 -0
  222. package/dist/tests/target-guard.test.d.ts +2 -0
  223. package/dist/tests/target-guard.test.d.ts.map +1 -0
  224. package/dist/tests/target-guard.test.js +132 -0
  225. package/dist/tests/target-guard.test.js.map +1 -0
  226. package/dist/ui/logo.d.ts +2 -0
  227. package/dist/ui/logo.d.ts.map +1 -0
  228. package/dist/ui/logo.js +22 -0
  229. package/dist/ui/logo.js.map +1 -0
  230. package/package.json +17 -53
  231. package/.claude/settings.local.json +0 -36
  232. package/.cursor/rules.md +0 -203
  233. package/.eslintrc.js +0 -31
  234. package/CLAUDE.md +0 -100
  235. package/bin/cli.js +0 -116
  236. package/docs/ADDING_FRAMEWORK_DETECTORS.md +0 -391
  237. package/docs/ADDING_NEW_PROJECT_TYPE.md +0 -156
  238. package/docs/ARCHITECTURE_RELATIONSHIPS.md +0 -411
  239. package/docs/CLI_AUTHENTICATION.md +0 -214
  240. package/docs/CLI_PAGE_DETECTION_REQUIREMENTS.md +0 -519
  241. package/docs/CRM-PIPELINES-SEQUENCES-SPEC.md +0 -429
  242. package/docs/DETECTOR_ARCHITECTURE.md +0 -326
  243. package/docs/DEVELOPMENT.md +0 -194
  244. package/docs/IMPLEMENTATION_PHASES.md +0 -468
  245. package/docs/INTEGRATION_PATHS_ARCHITECTURE.md +0 -1543
  246. package/docs/OAUTH_CLARIFICATION.md +0 -258
  247. package/docs/OAUTH_SETUP_GUIDE_TEMPLATE.md +0 -211
  248. package/docs/PHASE_0_PROGRESS.md +0 -120
  249. package/docs/PHASE_1_COMPLETE.md +0 -366
  250. package/docs/PHASE_SUMMARY.md +0 -149
  251. package/docs/PLAN.md +0 -511
  252. package/docs/README.md +0 -56
  253. package/docs/STRIPE_INTEGRATION.md +0 -447
  254. package/docs/SUMMARY.md +0 -230
  255. package/docs/UPDATED_PLAN.md +0 -447
  256. package/docs/mcp_server/MCP_EXTENSION_GUIDE.md +0 -1313
  257. package/docs/mcp_server/MCP_SERVER_ARCHITECTURE.md +0 -1481
  258. package/docs/mcp_server/applicationOntology.ts +0 -817
  259. package/docs/mcp_server/cliApplications.ts +0 -639
  260. package/docs/mcp_server/crmOntology.ts +0 -1063
  261. package/docs/mcp_server/eventOntology.ts +0 -1183
  262. package/docs/mcp_server/formsOntology.ts +0 -1401
  263. package/docs/mcp_server/ontologySchemas.ts +0 -185
  264. package/docs/mcp_server/schema.ts +0 -250
  265. package/docs/microsass_production_machine/CLI_API_REFERENCE.md +0 -1197
  266. package/docs/microsass_production_machine/CLI_PRODUCT_VISION.md +0 -676
  267. package/docs/microsass_production_machine/CLI_REQUIREMENTS.md +0 -606
  268. package/docs/microsass_production_machine/CONNECTED_APPLICATIONS_SPEC.md +0 -390
  269. package/docs/microsass_production_machine/IMPLEMENTATION_ROADMAP.md +0 -725
  270. package/docs/microsass_production_machine/OBJECT_MAPPINGS.md +0 -808
  271. package/docs/microsass_production_machine/REFERENCE_IMPLEMENTATION.md +0 -532
  272. package/src/api/backend-client.js +0 -449
  273. package/src/commands/api-keys.js +0 -119
  274. package/src/commands/connect.js +0 -243
  275. package/src/commands/login.js +0 -332
  276. package/src/commands/logout.js +0 -30
  277. package/src/commands/mcp-server.js +0 -85
  278. package/src/commands/mcp-setup.js +0 -686
  279. package/src/commands/pages.js +0 -317
  280. package/src/commands/scaffold.js +0 -409
  281. package/src/commands/spread.js +0 -861
  282. package/src/commands/status.js +0 -62
  283. package/src/commands/sync.js +0 -169
  284. package/src/commands/upgrade.js +0 -48
  285. package/src/config/config-manager.js +0 -206
  286. package/src/detectors/api-client-detector.js +0 -85
  287. package/src/detectors/base-detector.js +0 -77
  288. package/src/detectors/database-detector.js +0 -245
  289. package/src/detectors/expo-detector.js +0 -166
  290. package/src/detectors/github-detector.js +0 -74
  291. package/src/detectors/index.js +0 -106
  292. package/src/detectors/mapping-suggestor.js +0 -119
  293. package/src/detectors/model-detector.js +0 -318
  294. package/src/detectors/nextjs-detector.js +0 -139
  295. package/src/detectors/oauth-detector.js +0 -122
  296. package/src/detectors/page-detector.js +0 -480
  297. package/src/detectors/registry.js +0 -121
  298. package/src/generators/api-client-generator.js +0 -223
  299. package/src/generators/api-only/client.js +0 -683
  300. package/src/generators/api-only/index.js +0 -96
  301. package/src/generators/api-only/types.js +0 -618
  302. package/src/generators/api-only/webhooks.js +0 -377
  303. package/src/generators/env-generator.js +0 -191
  304. package/src/generators/expo-auth-generator.js +0 -1009
  305. package/src/generators/gitignore-generator.js +0 -92
  306. package/src/generators/index.js +0 -166
  307. package/src/generators/manifest-generator.js +0 -154
  308. package/src/generators/mcp-guide-generator.js +0 -256
  309. package/src/generators/nextauth-generator.js +0 -247
  310. package/src/generators/oauth-guide-generator.js +0 -277
  311. package/src/generators/quickstart/components/index.js +0 -1699
  312. package/src/generators/quickstart/components-mobile/index.js +0 -1440
  313. package/src/generators/quickstart/database/convex.js +0 -1257
  314. package/src/generators/quickstart/database/index.js +0 -34
  315. package/src/generators/quickstart/database/supabase.js +0 -1132
  316. package/src/generators/quickstart/hooks/index.js +0 -1065
  317. package/src/generators/quickstart/index.js +0 -191
  318. package/src/generators/quickstart/pages/index.js +0 -1466
  319. package/src/generators/quickstart/screens/index.js +0 -1498
  320. package/src/logo.js +0 -116
  321. package/src/mcp/auth.js +0 -127
  322. package/src/mcp/registry/domains/applications.js +0 -516
  323. package/src/mcp/registry/domains/benefits.js +0 -798
  324. package/src/mcp/registry/domains/codegen.js +0 -894
  325. package/src/mcp/registry/domains/core.js +0 -324
  326. package/src/mcp/registry/domains/crm.js +0 -591
  327. package/src/mcp/registry/domains/events.js +0 -649
  328. package/src/mcp/registry/domains/forms.js +0 -696
  329. package/src/mcp/registry/index.js +0 -164
  330. package/src/mcp/server.js +0 -116
  331. package/src/utils/file-utils.js +0 -117
  332. package/src/utils/init-helpers.js +0 -243
  333. package/src/utils/prompt-utils.js +0 -195
  334. package/templates/CLAUDE.md +0 -86
  335. package/tests/api-client-detector.test.js +0 -214
  336. package/tests/api-client-generator.test.js +0 -176
  337. package/tests/backend-client.test.js +0 -640
  338. package/tests/base-detector.test.js +0 -101
  339. package/tests/commands/login.test.js +0 -143
  340. package/tests/commands/logout.test.js +0 -84
  341. package/tests/commands/status.test.js +0 -167
  342. package/tests/config-manager.test.js +0 -321
  343. package/tests/database-detector.test.js +0 -221
  344. package/tests/detector-index.test.js +0 -209
  345. package/tests/detector-registry.test.js +0 -93
  346. package/tests/env-generator.test.js +0 -278
  347. package/tests/expo-detector.test.js +0 -263
  348. package/tests/file-utils.test.js +0 -194
  349. package/tests/generators-index.test.js +0 -454
  350. package/tests/github-detector.test.js +0 -145
  351. package/tests/gitignore-generator.test.js +0 -109
  352. package/tests/logo.test.js +0 -96
  353. package/tests/nextauth-generator.test.js +0 -255
  354. package/tests/nextjs-detector.test.js +0 -235
  355. package/tests/oauth-detector.test.js +0 -264
  356. package/tests/oauth-guide-generator.test.js +0 -273
  357. package/tests/page-detector.test.js +0 -371
@@ -1,1197 +0,0 @@
1
- # L4YERCAK3 CLI - API Reference
2
-
3
- Complete reference for all backend APIs available via CLI.
4
-
5
- ---
6
-
7
- ## Authentication
8
-
9
- ### CLI Session Management
10
-
11
- | Endpoint | Method | Description |
12
- |----------|--------|-------------|
13
- | `/api/v1/auth/cli/validate` | GET | Validate CLI session token |
14
- | `/api/v1/auth/cli/refresh` | POST | Refresh CLI session token |
15
- | `/auth/cli-login` | GET | Browser OAuth login page |
16
- | `/api/auth/oauth-signup` | GET | Direct OAuth provider redirect |
17
-
18
- **CLI Session Token Format:** `cli_session_{64_hex_chars}`
19
-
20
- **Session Lifetime:** 30 days
21
-
22
- ---
23
-
24
- ## Organizations
25
-
26
- ### List Organizations
27
- ```
28
- GET /api/v1/organizations
29
- Authorization: Bearer {cli_token}
30
- ```
31
-
32
- Response:
33
- ```json
34
- {
35
- "organizations": [
36
- {
37
- "id": "org_xxx",
38
- "name": "My Company",
39
- "slug": "my-company",
40
- "planTier": "starter"
41
- }
42
- ]
43
- }
44
- ```
45
-
46
- ### Create Organization
47
- ```
48
- POST /api/v1/organizations
49
- Authorization: Bearer {cli_token}
50
-
51
- {
52
- "name": "New Organization"
53
- }
54
- ```
55
-
56
- ---
57
-
58
- ## API Keys
59
-
60
- ### List API Keys
61
- ```
62
- GET /api/v1/api-keys/list?organizationId={org_id}
63
- Authorization: Bearer {cli_token}
64
- ```
65
-
66
- Response:
67
- ```json
68
- {
69
- "keys": [
70
- {
71
- "id": "key_xxx",
72
- "name": "CLI Generated Key",
73
- "keyPreview": "sk_live_xxx...",
74
- "scopes": ["*"],
75
- "status": "active",
76
- "createdAt": 1704067200000
77
- }
78
- ],
79
- "limit": 3,
80
- "currentCount": 1,
81
- "canCreateMore": true,
82
- "limitDescription": "1/3"
83
- }
84
- ```
85
-
86
- ### Generate API Key
87
- ```
88
- POST /api/v1/api-keys/generate
89
- Authorization: Bearer {cli_token}
90
-
91
- {
92
- "organizationId": "org_xxx",
93
- "name": "Production API Key",
94
- "scopes": ["*"]
95
- }
96
- ```
97
-
98
- Response:
99
- ```json
100
- {
101
- "id": "key_xxx",
102
- "key": "l4yer_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
103
- "name": "Production API Key",
104
- "scopes": ["*"],
105
- "createdAt": 1704067200000
106
- }
107
- ```
108
-
109
- ---
110
-
111
- ## CRM - Contacts
112
-
113
- ### List Contacts
114
- ```
115
- GET /api/v1/crm/contacts?organizationId={org_id}&limit=50&offset=0
116
- Authorization: Bearer {api_key}
117
- ```
118
-
119
- Response:
120
- ```json
121
- {
122
- "contacts": [
123
- {
124
- "id": "obj_xxx",
125
- "type": "contact",
126
- "displayName": "John Doe",
127
- "customProperties": {
128
- "email": "john@example.com",
129
- "phone": "+1234567890",
130
- "company": "Acme Corp"
131
- },
132
- "createdAt": 1704067200000,
133
- "updatedAt": 1704067200000
134
- }
135
- ],
136
- "total": 150,
137
- "hasMore": true
138
- }
139
- ```
140
-
141
- ### Create Contact
142
- ```
143
- POST /api/v1/crm/contacts
144
- Authorization: Bearer {api_key}
145
-
146
- {
147
- "organizationId": "org_xxx",
148
- "displayName": "Jane Smith",
149
- "email": "jane@example.com",
150
- "phone": "+1234567890",
151
- "company": "Acme Corp",
152
- "customFields": {
153
- "department": "Engineering"
154
- }
155
- }
156
- ```
157
-
158
- ### Get Contact
159
- ```
160
- GET /api/v1/crm/contacts/{contactId}
161
- Authorization: Bearer {api_key}
162
- ```
163
-
164
- ### Update Contact
165
- ```
166
- PATCH /api/v1/crm/contacts/{contactId}
167
- Authorization: Bearer {api_key}
168
-
169
- {
170
- "displayName": "Jane Doe",
171
- "customFields": {
172
- "title": "Senior Engineer"
173
- }
174
- }
175
- ```
176
-
177
- ### Delete Contact
178
- ```
179
- DELETE /api/v1/crm/contacts/{contactId}
180
- Authorization: Bearer {api_key}
181
- ```
182
-
183
- ### Create Contact from Event Registration
184
- ```
185
- POST /api/v1/crm/contacts/from-event
186
- Authorization: Bearer {api_key}
187
-
188
- {
189
- "organizationId": "org_xxx",
190
- "eventId": "obj_event_xxx",
191
- "attendeeData": {
192
- "email": "attendee@example.com",
193
- "firstName": "John",
194
- "lastName": "Doe"
195
- }
196
- }
197
- ```
198
-
199
- ---
200
-
201
- ## CRM - Organizations
202
-
203
- ### List CRM Organizations
204
- ```
205
- GET /api/v1/crm/organizations?organizationId={org_id}
206
- Authorization: Bearer {api_key}
207
- ```
208
-
209
- ### Create CRM Organization
210
- ```
211
- POST /api/v1/crm/organizations
212
- Authorization: Bearer {api_key}
213
-
214
- {
215
- "organizationId": "org_xxx",
216
- "name": "Client Company Inc",
217
- "website": "https://clientcompany.com",
218
- "industry": "Technology",
219
- "taxId": "DE123456789"
220
- }
221
- ```
222
-
223
- ---
224
-
225
- ## Events
226
-
227
- ### List Events
228
- ```
229
- GET /api/v1/events?organizationId={org_id}&status=published
230
- Authorization: Bearer {api_key}
231
- ```
232
-
233
- Response:
234
- ```json
235
- {
236
- "events": [
237
- {
238
- "id": "obj_xxx",
239
- "type": "event",
240
- "subtype": "conference",
241
- "status": "published",
242
- "displayName": "Tech Conference 2025",
243
- "customProperties": {
244
- "startDate": "2025-06-15T09:00:00Z",
245
- "endDate": "2025-06-17T18:00:00Z",
246
- "location": "Berlin, Germany",
247
- "capacity": 500,
248
- "registeredCount": 342
249
- }
250
- }
251
- ]
252
- }
253
- ```
254
-
255
- ### Create Event
256
- ```
257
- POST /api/v1/events
258
- Authorization: Bearer {api_key}
259
-
260
- {
261
- "organizationId": "org_xxx",
262
- "name": "Product Launch 2025",
263
- "subtype": "conference",
264
- "startDate": "2025-06-15T09:00:00Z",
265
- "endDate": "2025-06-15T18:00:00Z",
266
- "location": "Berlin",
267
- "capacity": 200,
268
- "description": "Annual product launch event"
269
- }
270
- ```
271
-
272
- ### Get Event
273
- ```
274
- GET /api/v1/events/{eventId}
275
- Authorization: Bearer {api_key}
276
- ```
277
-
278
- ### Update Event
279
- ```
280
- PATCH /api/v1/events/{eventId}
281
- Authorization: Bearer {api_key}
282
-
283
- {
284
- "status": "published",
285
- "capacity": 300
286
- }
287
- ```
288
-
289
- ### Delete Event
290
- ```
291
- DELETE /api/v1/events/{eventId}
292
- Authorization: Bearer {api_key}
293
- ```
294
-
295
- ---
296
-
297
- ## Products
298
-
299
- ### List Products
300
- ```
301
- GET /api/v1/products?organizationId={org_id}
302
- Authorization: Bearer {api_key}
303
- ```
304
-
305
- Response:
306
- ```json
307
- {
308
- "products": [
309
- {
310
- "id": "obj_xxx",
311
- "type": "product",
312
- "subtype": "ticket",
313
- "status": "active",
314
- "displayName": "Early Bird Ticket",
315
- "customProperties": {
316
- "price": 19900,
317
- "currency": "EUR",
318
- "quantity": 100,
319
- "sold": 45,
320
- "linkedEventId": "obj_event_xxx"
321
- }
322
- }
323
- ]
324
- }
325
- ```
326
-
327
- ### Create Product
328
- ```
329
- POST /api/v1/products
330
- Authorization: Bearer {api_key}
331
-
332
- {
333
- "organizationId": "org_xxx",
334
- "name": "VIP Ticket",
335
- "subtype": "ticket",
336
- "price": 49900,
337
- "currency": "EUR",
338
- "quantity": 50,
339
- "linkedEventId": "obj_xxx",
340
- "description": "VIP access with backstage pass"
341
- }
342
- ```
343
-
344
- ### Get Product
345
- ```
346
- GET /api/v1/products/{productId}
347
- Authorization: Bearer {api_key}
348
- ```
349
-
350
- ### Update Product
351
- ```
352
- PATCH /api/v1/products/{productId}
353
- Authorization: Bearer {api_key}
354
-
355
- {
356
- "price": 39900,
357
- "status": "active"
358
- }
359
- ```
360
-
361
- ### Delete Product
362
- ```
363
- DELETE /api/v1/products/{productId}
364
- Authorization: Bearer {api_key}
365
- ```
366
-
367
- ---
368
-
369
- ## Tickets
370
-
371
- ### List Tickets
372
- ```
373
- GET /api/v1/tickets?organizationId={org_id}&eventId={event_id}
374
- Authorization: Bearer {api_key}
375
- ```
376
-
377
- Response:
378
- ```json
379
- {
380
- "tickets": [
381
- {
382
- "id": "obj_xxx",
383
- "type": "ticket",
384
- "status": "valid",
385
- "displayName": "Ticket #001",
386
- "customProperties": {
387
- "qrCode": "TKT-ABC123-XYZ",
388
- "attendeeName": "John Doe",
389
- "attendeeEmail": "john@example.com",
390
- "productId": "obj_product_xxx",
391
- "eventId": "obj_event_xxx",
392
- "checkedIn": false,
393
- "checkedInAt": null
394
- }
395
- }
396
- ]
397
- }
398
- ```
399
-
400
- ### Generate Ticket
401
- ```
402
- POST /api/v1/tickets
403
- Authorization: Bearer {api_key}
404
-
405
- {
406
- "organizationId": "org_xxx",
407
- "productId": "obj_xxx",
408
- "eventId": "obj_xxx",
409
- "attendeeName": "Jane Doe",
410
- "attendeeEmail": "jane@example.com",
411
- "formResponseData": {
412
- "dietaryRequirements": "vegetarian"
413
- }
414
- }
415
- ```
416
-
417
- ### Redeem Ticket (Check-in)
418
- ```
419
- POST /api/v1/tickets/{ticketId}/redeem
420
- Authorization: Bearer {api_key}
421
- ```
422
-
423
- ### Get Ticket PDF
424
- ```
425
- GET /api/v1/tickets/{ticketId}/pdf
426
- Authorization: Bearer {api_key}
427
-
428
- Response: application/pdf
429
- ```
430
-
431
- ### Bulk Export Tickets
432
- ```
433
- GET /api/v1/tickets/export?eventId={event_id}&format=csv
434
- Authorization: Bearer {api_key}
435
-
436
- Response: text/csv
437
- ```
438
-
439
- ---
440
-
441
- ## Checkout & Transactions
442
-
443
- ### Create Checkout Session
444
- ```
445
- POST /api/v1/checkout/sessions
446
- Authorization: Bearer {api_key}
447
-
448
- {
449
- "organizationId": "org_xxx",
450
- "productId": "obj_xxx",
451
- "customerEmail": "customer@example.com",
452
- "successUrl": "https://myapp.com/success",
453
- "cancelUrl": "https://myapp.com/cancel"
454
- }
455
- ```
456
-
457
- Response:
458
- ```json
459
- {
460
- "sessionId": "cs_xxx",
461
- "checkoutUrl": "https://app.l4yercak3.com/checkout/cs_xxx",
462
- "expiresAt": 1704153600000
463
- }
464
- ```
465
-
466
- ### Verify Payment
467
- ```
468
- POST /api/v1/checkout/confirm
469
- Authorization: Bearer {api_key}
470
-
471
- {
472
- "sessionId": "cs_xxx"
473
- }
474
- ```
475
-
476
- ### List Transactions
477
- ```
478
- GET /api/v1/transactions?organizationId={org_id}
479
- Authorization: Bearer {api_key}
480
- ```
481
-
482
- Response:
483
- ```json
484
- {
485
- "transactions": [
486
- {
487
- "id": "obj_xxx",
488
- "type": "transaction",
489
- "status": "completed",
490
- "displayName": "Order #12345",
491
- "customProperties": {
492
- "lineItems": [
493
- {
494
- "productId": "obj_xxx",
495
- "productName": "Early Bird Ticket",
496
- "quantity": 2,
497
- "unitPrice": 19900,
498
- "total": 39800
499
- }
500
- ],
501
- "subtotal": 39800,
502
- "tax": 7562,
503
- "total": 47362,
504
- "currency": "EUR",
505
- "customerEmail": "customer@example.com",
506
- "paymentMethod": "card"
507
- }
508
- }
509
- ]
510
- }
511
- ```
512
-
513
- ### Get Transaction
514
- ```
515
- GET /api/v1/transactions/{transactionId}
516
- Authorization: Bearer {api_key}
517
- ```
518
-
519
- ---
520
-
521
- ## Invoices
522
-
523
- ### List Invoices
524
- ```
525
- GET /api/v1/invoices?organizationId={org_id}&status=sent
526
- Authorization: Bearer {api_key}
527
- ```
528
-
529
- Response:
530
- ```json
531
- {
532
- "invoices": [
533
- {
534
- "id": "obj_xxx",
535
- "type": "invoice",
536
- "status": "sent",
537
- "displayName": "INV-2025-001",
538
- "customProperties": {
539
- "invoiceNumber": "INV-2025-001",
540
- "clientId": "obj_contact_xxx",
541
- "clientName": "Acme Corp",
542
- "lineItems": [
543
- {
544
- "description": "Consulting Services",
545
- "quantity": 10,
546
- "unitPrice": 15000,
547
- "total": 150000
548
- }
549
- ],
550
- "subtotal": 150000,
551
- "taxRate": 19,
552
- "tax": 28500,
553
- "total": 178500,
554
- "currency": "EUR",
555
- "dueDate": "2025-02-15",
556
- "paymentTerms": "net30"
557
- }
558
- }
559
- ]
560
- }
561
- ```
562
-
563
- ### Create Invoice
564
- ```
565
- POST /api/v1/invoices
566
- Authorization: Bearer {api_key}
567
-
568
- {
569
- "organizationId": "org_xxx",
570
- "clientId": "obj_contact_xxx",
571
- "lineItems": [
572
- {
573
- "description": "Website Development",
574
- "quantity": 1,
575
- "unitPrice": 500000
576
- }
577
- ],
578
- "taxRate": 19,
579
- "currency": "EUR",
580
- "dueDate": "2025-02-28",
581
- "paymentTerms": "net30",
582
- "notes": "Thank you for your business!"
583
- }
584
- ```
585
-
586
- ### Get Invoice
587
- ```
588
- GET /api/v1/invoices/{invoiceId}
589
- Authorization: Bearer {api_key}
590
- ```
591
-
592
- ### Update Invoice (Draft Only)
593
- ```
594
- PATCH /api/v1/invoices/{invoiceId}
595
- Authorization: Bearer {api_key}
596
-
597
- {
598
- "lineItems": [...],
599
- "notes": "Updated notes"
600
- }
601
- ```
602
-
603
- ### Seal Invoice
604
- ```
605
- POST /api/v1/invoices/{invoiceId}/seal
606
- Authorization: Bearer {api_key}
607
- ```
608
-
609
- ### Send Invoice
610
- ```
611
- POST /api/v1/invoices/{invoiceId}/send
612
- Authorization: Bearer {api_key}
613
-
614
- {
615
- "recipientEmail": "client@acmecorp.com",
616
- "message": "Please find attached invoice."
617
- }
618
- ```
619
-
620
- ### Mark as Paid
621
- ```
622
- POST /api/v1/invoices/{invoiceId}/mark-paid
623
- Authorization: Bearer {api_key}
624
-
625
- {
626
- "paidAmount": 178500,
627
- "paymentMethod": "bank_transfer",
628
- "paymentDate": "2025-01-20"
629
- }
630
- ```
631
-
632
- ### Get Invoice PDF
633
- ```
634
- GET /api/v1/invoices/{invoiceId}/pdf
635
- Authorization: Bearer {api_key}
636
-
637
- Response: application/pdf
638
- ```
639
-
640
- ### Sync Invoice to Stripe
641
- ```
642
- POST /api/v1/invoices/{invoiceId}/sync-stripe
643
- Authorization: Bearer {api_key}
644
- ```
645
-
646
- ---
647
-
648
- ## Forms
649
-
650
- ### List Forms
651
- ```
652
- GET /api/v1/forms?organizationId={org_id}
653
- Authorization: Bearer {api_key}
654
- ```
655
-
656
- Response:
657
- ```json
658
- {
659
- "forms": [
660
- {
661
- "id": "obj_xxx",
662
- "type": "form",
663
- "subtype": "registration",
664
- "status": "published",
665
- "displayName": "Event Registration",
666
- "customProperties": {
667
- "fields": [
668
- {
669
- "id": "f1",
670
- "type": "text",
671
- "label": "Full Name",
672
- "required": true
673
- },
674
- {
675
- "id": "f2",
676
- "type": "email",
677
- "label": "Email",
678
- "required": true
679
- }
680
- ],
681
- "responseCount": 45
682
- }
683
- }
684
- ]
685
- }
686
- ```
687
-
688
- ### Create Form
689
- ```
690
- POST /api/v1/forms
691
- Authorization: Bearer {api_key}
692
-
693
- {
694
- "organizationId": "org_xxx",
695
- "name": "Workshop Registration",
696
- "subtype": "registration",
697
- "fields": [
698
- {
699
- "type": "text",
700
- "label": "Name",
701
- "required": true
702
- },
703
- {
704
- "type": "email",
705
- "label": "Email",
706
- "required": true
707
- },
708
- {
709
- "type": "select",
710
- "label": "Experience Level",
711
- "options": ["Beginner", "Intermediate", "Advanced"],
712
- "required": true
713
- }
714
- ]
715
- }
716
- ```
717
-
718
- ### Submit Form Response
719
- ```
720
- POST /api/v1/forms/{formId}/submit
721
- Authorization: Bearer {api_key}
722
-
723
- {
724
- "responses": {
725
- "f1": "John Doe",
726
- "f2": "john@example.com",
727
- "f3": "Intermediate"
728
- }
729
- }
730
- ```
731
-
732
- ### Get Form Responses
733
- ```
734
- GET /api/v1/forms/{formId}/responses
735
- Authorization: Bearer {api_key}
736
- ```
737
-
738
- ### Export Form Responses
739
- ```
740
- GET /api/v1/forms/{formId}/export?format=csv
741
- Authorization: Bearer {api_key}
742
-
743
- Response: text/csv
744
- ```
745
-
746
- ---
747
-
748
- ## Projects
749
-
750
- ### List Projects
751
- ```
752
- GET /api/v1/projects?organizationId={org_id}
753
- Authorization: Bearer {api_key}
754
- ```
755
-
756
- Response:
757
- ```json
758
- {
759
- "projects": [
760
- {
761
- "id": "obj_xxx",
762
- "type": "project",
763
- "status": "active",
764
- "displayName": "Brand Redesign",
765
- "customProperties": {
766
- "clientId": "obj_contact_xxx",
767
- "clientName": "Acme Corp",
768
- "budget": 1500000,
769
- "startDate": "2025-01-01",
770
- "endDate": "2025-03-31",
771
- "progress": 35,
772
- "milestones": [
773
- {
774
- "id": "m1",
775
- "name": "Discovery",
776
- "status": "completed"
777
- }
778
- ]
779
- }
780
- }
781
- ]
782
- }
783
- ```
784
-
785
- ### Create Project
786
- ```
787
- POST /api/v1/projects
788
- Authorization: Bearer {api_key}
789
-
790
- {
791
- "organizationId": "org_xxx",
792
- "name": "Website Redesign",
793
- "clientId": "obj_xxx",
794
- "budget": 2000000,
795
- "startDate": "2025-02-01",
796
- "endDate": "2025-05-31",
797
- "description": "Complete website overhaul"
798
- }
799
- ```
800
-
801
- ### Get Project
802
- ```
803
- GET /api/v1/projects/{projectId}
804
- Authorization: Bearer {api_key}
805
- ```
806
-
807
- ### Update Project
808
- ```
809
- PATCH /api/v1/projects/{projectId}
810
- Authorization: Bearer {api_key}
811
-
812
- {
813
- "status": "completed",
814
- "progress": 100
815
- }
816
- ```
817
-
818
- ### Add Task to Project
819
- ```
820
- POST /api/v1/projects/{projectId}/tasks
821
- Authorization: Bearer {api_key}
822
-
823
- {
824
- "title": "Design mockups",
825
- "description": "Create initial design mockups",
826
- "assigneeId": "user_xxx",
827
- "dueDate": "2025-02-15",
828
- "priority": "high"
829
- }
830
- ```
831
-
832
- ### List Project Tasks
833
- ```
834
- GET /api/v1/projects/{projectId}/tasks
835
- Authorization: Bearer {api_key}
836
- ```
837
-
838
- ---
839
-
840
- ## Workflows
841
-
842
- ### List Workflows
843
- ```
844
- GET /api/v1/workflows?organizationId={org_id}
845
- Authorization: Bearer {api_key}
846
- ```
847
-
848
- ### Create Workflow
849
- ```
850
- POST /api/v1/workflows
851
- Authorization: Bearer {api_key}
852
-
853
- {
854
- "organizationId": "org_xxx",
855
- "name": "New Contact Welcome",
856
- "trigger": {
857
- "type": "contact_created"
858
- },
859
- "actions": [
860
- {
861
- "type": "send_email",
862
- "templateId": "obj_template_xxx",
863
- "delay": 0
864
- }
865
- ]
866
- }
867
- ```
868
-
869
- ### Update Workflow
870
- ```
871
- PATCH /api/v1/workflows/{workflowId}
872
- Authorization: Bearer {api_key}
873
-
874
- {
875
- "status": "active"
876
- }
877
- ```
878
-
879
- ### Manually Trigger Workflow
880
- ```
881
- POST /api/v1/workflows/{workflowId}/run
882
- Authorization: Bearer {api_key}
883
-
884
- {
885
- "contextData": {
886
- "contactId": "obj_xxx"
887
- }
888
- }
889
- ```
890
-
891
- ### Get Workflow Logs
892
- ```
893
- GET /api/v1/workflows/{workflowId}/logs
894
- Authorization: Bearer {api_key}
895
- ```
896
-
897
- ---
898
-
899
- ## Templates
900
-
901
- ### List Templates
902
- ```
903
- GET /api/v1/templates?organizationId={org_id}&type=email
904
- Authorization: Bearer {api_key}
905
- ```
906
-
907
- Response:
908
- ```json
909
- {
910
- "templates": [
911
- {
912
- "id": "obj_xxx",
913
- "type": "template",
914
- "subtype": "email",
915
- "displayName": "Invoice Email",
916
- "customProperties": {
917
- "subject": "Invoice {{invoiceNumber}} from {{organizationName}}",
918
- "htmlContent": "...",
919
- "variables": ["invoiceNumber", "organizationName", "clientName"]
920
- }
921
- }
922
- ]
923
- }
924
- ```
925
-
926
- ### Get Template
927
- ```
928
- GET /api/v1/templates/{templateId}
929
- Authorization: Bearer {api_key}
930
- ```
931
-
932
- ### Preview Template (with data)
933
- ```
934
- POST /api/v1/templates/{templateId}/preview
935
- Authorization: Bearer {api_key}
936
-
937
- {
938
- "data": {
939
- "invoiceNumber": "INV-2025-001",
940
- "organizationName": "My Company",
941
- "clientName": "Acme Corp"
942
- }
943
- }
944
- ```
945
-
946
- ---
947
-
948
- ## Bookings
949
-
950
- ### Create Booking
951
- ```
952
- POST /api/v1/bookings
953
- Authorization: Bearer {api_key}
954
-
955
- {
956
- "organizationId": "org_xxx",
957
- "eventId": "obj_xxx",
958
- "productId": "obj_xxx",
959
- "attendeeEmail": "attendee@example.com",
960
- "attendeeName": "John Doe",
961
- "quantity": 2
962
- }
963
- ```
964
-
965
- ### List Bookings
966
- ```
967
- GET /api/v1/bookings?organizationId={org_id}&eventId={event_id}
968
- Authorization: Bearer {api_key}
969
- ```
970
-
971
- ---
972
-
973
- ## Webhooks
974
-
975
- ### List Webhook Subscriptions
976
- ```
977
- GET /api/v1/webhooks?organizationId={org_id}
978
- Authorization: Bearer {api_key}
979
- ```
980
-
981
- ### Create Webhook
982
- ```
983
- POST /api/v1/webhooks
984
- Authorization: Bearer {api_key}
985
-
986
- {
987
- "organizationId": "org_xxx",
988
- "url": "https://myapp.com/webhook",
989
- "events": ["contact.created", "transaction.completed", "invoice.paid"],
990
- "secret": "whsec_xxx"
991
- }
992
- ```
993
-
994
- ### Delete Webhook
995
- ```
996
- DELETE /api/v1/webhooks/{webhookId}
997
- Authorization: Bearer {api_key}
998
- ```
999
-
1000
- ### Test Webhook
1001
- ```
1002
- POST /api/v1/webhooks/{webhookId}/test
1003
- Authorization: Bearer {api_key}
1004
- ```
1005
-
1006
- ---
1007
-
1008
- ## Bulk Operations
1009
-
1010
- ### Bulk Import
1011
- ```
1012
- POST /api/v1/bulk/import
1013
- Authorization: Bearer {api_key}
1014
- Content-Type: multipart/form-data
1015
-
1016
- file: (CSV or JSON file)
1017
- type: contacts | products | events
1018
- organizationId: org_xxx
1019
- options: {
1020
- "updateExisting": true,
1021
- "skipInvalid": true
1022
- }
1023
- ```
1024
-
1025
- Response:
1026
- ```json
1027
- {
1028
- "jobId": "bulk_xxx",
1029
- "status": "processing",
1030
- "total": 500,
1031
- "processed": 0,
1032
- "errors": []
1033
- }
1034
- ```
1035
-
1036
- ### Bulk Export
1037
- ```
1038
- POST /api/v1/bulk/export
1039
- Authorization: Bearer {api_key}
1040
-
1041
- {
1042
- "organizationId": "org_xxx",
1043
- "type": "contacts",
1044
- "format": "csv",
1045
- "filters": {
1046
- "createdAfter": "2024-01-01"
1047
- }
1048
- }
1049
- ```
1050
-
1051
- Response:
1052
- ```json
1053
- {
1054
- "jobId": "export_xxx",
1055
- "downloadUrl": "https://...",
1056
- "expiresAt": 1704153600000
1057
- }
1058
- ```
1059
-
1060
- ### Get Bulk Job Status
1061
- ```
1062
- GET /api/v1/bulk/jobs/{jobId}
1063
- Authorization: Bearer {api_key}
1064
- ```
1065
-
1066
- ---
1067
-
1068
- ## Connected Apps (CLI Registration)
1069
-
1070
- ### Register Connected App
1071
- ```
1072
- POST /api/v1/cli/apps/register
1073
- Authorization: Bearer {cli_token}
1074
-
1075
- {
1076
- "organizationId": "org_xxx",
1077
- "name": "My Benefits Platform",
1078
- "framework": "nextjs",
1079
- "features": ["crm", "benefits", "invoicing"],
1080
- "modelMappings": [
1081
- {
1082
- "localModel": "User",
1083
- "layerCakeType": "contact",
1084
- "syncDirection": "bidirectional",
1085
- "fieldMappings": [
1086
- {"localField": "email", "layerCakeField": "email"},
1087
- {"localField": "name", "layerCakeField": "displayName"}
1088
- ]
1089
- }
1090
- ],
1091
- "productionDomain": "myapp.vercel.app"
1092
- }
1093
- ```
1094
-
1095
- ### List Connected Apps
1096
- ```
1097
- GET /api/v1/cli/apps?organizationId={org_id}
1098
- Authorization: Bearer {cli_token}
1099
- ```
1100
-
1101
- ### Update Connected App
1102
- ```
1103
- PATCH /api/v1/cli/apps/{appId}
1104
- Authorization: Bearer {cli_token}
1105
-
1106
- {
1107
- "status": "paused",
1108
- "modelMappings": [...]
1109
- }
1110
- ```
1111
-
1112
- ### Disconnect App
1113
- ```
1114
- DELETE /api/v1/cli/apps/{appId}
1115
- Authorization: Bearer {cli_token}
1116
- ```
1117
-
1118
- ### Sync App Data
1119
- ```
1120
- POST /api/v1/cli/apps/{appId}/sync
1121
- Authorization: Bearer {cli_token}
1122
-
1123
- {
1124
- "direction": "bidirectional",
1125
- "models": ["contacts", "organizations"]
1126
- }
1127
- ```
1128
-
1129
- ---
1130
-
1131
- ## Error Codes
1132
-
1133
- | Code | HTTP Status | Description |
1134
- |------|-------------|-------------|
1135
- | `UNAUTHORIZED` | 401 | Missing or invalid authentication |
1136
- | `SESSION_EXPIRED` | 401 | CLI session expired |
1137
- | `NOT_AUTHORIZED` | 403 | No permission for this resource |
1138
- | `NOT_FOUND` | 404 | Resource not found |
1139
- | `VALIDATION_ERROR` | 400 | Invalid request data |
1140
- | `MISSING_PARAM` | 400 | Required parameter missing |
1141
- | `API_KEY_LIMIT_REACHED` | 429 | API key quota exceeded |
1142
- | `RATE_LIMITED` | 429 | Too many requests |
1143
- | `RESOURCE_LIMIT` | 429 | Plan resource limit reached |
1144
- | `UNKNOWN_ERROR` | 500 | Internal server error |
1145
-
1146
- ---
1147
-
1148
- ## Rate Limits
1149
-
1150
- | Plan | Requests/minute | Bulk operations/day |
1151
- |------|-----------------|---------------------|
1152
- | Free | 60 | 10 |
1153
- | Starter | 300 | 50 |
1154
- | Professional | 1000 | 200 |
1155
- | Agency | 3000 | 500 |
1156
- | Enterprise | Unlimited | Unlimited |
1157
-
1158
- ---
1159
-
1160
- ## Webhooks Payload Format
1161
-
1162
- ```json
1163
- {
1164
- "id": "evt_xxx",
1165
- "type": "contact.created",
1166
- "timestamp": 1704067200000,
1167
- "data": {
1168
- "id": "obj_xxx",
1169
- "type": "contact",
1170
- "displayName": "John Doe",
1171
- "customProperties": {...}
1172
- },
1173
- "organizationId": "org_xxx"
1174
- }
1175
- ```
1176
-
1177
- ### Available Webhook Events
1178
-
1179
- - `contact.created`
1180
- - `contact.updated`
1181
- - `contact.deleted`
1182
- - `transaction.completed`
1183
- - `transaction.refunded`
1184
- - `invoice.created`
1185
- - `invoice.sent`
1186
- - `invoice.paid`
1187
- - `event.published`
1188
- - `ticket.issued`
1189
- - `ticket.redeemed`
1190
- - `form.submitted`
1191
- - `project.created`
1192
- - `project.completed`
1193
-
1194
- ---
1195
-
1196
- *Document Version: 1.0*
1197
- *Last Updated: January 2025*