@json-to-office/core-docx 0.3.1 → 0.5.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.
@@ -1,73 +1,556 @@
1
1
  {
2
2
  "name": "docx",
3
3
  "props": {
4
- "metadata": { "title": "Platform Integration Guide" },
5
- "theme": "minimal"
4
+ "metadata": {
5
+ "title": "Arcline Platform — Integration Guide",
6
+ "author": "Arcline Engineering",
7
+ "description": "Technical reference for integrating external systems with the Arcline Platform API"
8
+ },
9
+ "theme": "devportal"
6
10
  },
7
11
  "children": [
8
12
  {
9
- "name": "header",
10
- "props": {
11
- "text": "Platform Integration Guide",
12
- "alignment": "left",
13
- "showPageNumbers": true
14
- }
15
- },
16
- {
17
- "name": "footer",
13
+ "name": "section",
18
14
  "props": {
19
- "text": "Confidential — TechCorp Inc.",
20
- "alignment": "center"
21
- }
15
+ "level": 1,
16
+ "header": [
17
+ {
18
+ "name": "header",
19
+ "props": {
20
+ "text": "Arcline Platform — Integration Guide v3.2",
21
+ "alignment": "left",
22
+ "showPageNumbers": true
23
+ }
24
+ }
25
+ ],
26
+ "footer": [
27
+ {
28
+ "name": "footer",
29
+ "props": {
30
+ "text": "Confidential — Arcline Inc. — Do not distribute",
31
+ "alignment": "center"
32
+ }
33
+ }
34
+ ]
35
+ },
36
+ "children": [
37
+ {
38
+ "name": "heading",
39
+ "props": {
40
+ "text": "Platform Integration Guide",
41
+ "level": 1
42
+ }
43
+ },
44
+ {
45
+ "name": "heading",
46
+ "props": {
47
+ "text": "Arcline API v3.2 — Technical Reference",
48
+ "level": 2
49
+ }
50
+ },
51
+ {
52
+ "name": "paragraph",
53
+ "props": {
54
+ "text": "Last updated: April 2026 | Audience: Developers, System Architects, DevOps Engineers",
55
+ "font": {
56
+ "italic": true,
57
+ "color": "textSecondary"
58
+ }
59
+ }
60
+ },
61
+ {
62
+ "name": "paragraph",
63
+ "props": {
64
+ "text": ""
65
+ }
66
+ },
67
+ {
68
+ "name": "image",
69
+ "props": {
70
+ "path": "https://placehold.co/800x200/0F172A/0D9488?text=ARCLINE+PLATFORM&font=helvetica",
71
+ "width": "100%",
72
+ "caption": "Arcline — Enterprise Data Platform"
73
+ }
74
+ },
75
+ {
76
+ "name": "paragraph",
77
+ "props": {
78
+ "text": ""
79
+ }
80
+ },
81
+ {
82
+ "name": "paragraph",
83
+ "props": {
84
+ "text": "This guide covers the integration of external systems with the Arcline Platform API. It is intended for developers and system architects building custom integrations, data pipelines, and embedded analytics solutions. The API follows RESTful conventions, uses OAuth 2.0 for authentication, and returns JSON responses."
85
+ }
86
+ },
87
+ {
88
+ "name": "toc",
89
+ "props": {
90
+ "depth": {
91
+ "from": 1,
92
+ "to": 2
93
+ }
94
+ }
95
+ }
96
+ ]
22
97
  },
23
- { "name": "toc", "props": { "depth": { "from": 1, "to": 2 } } },
24
98
  {
25
99
  "name": "section",
26
- "props": { "level": 1, "pageBreak": true },
100
+ "props": {
101
+ "level": 1,
102
+ "pageBreak": true,
103
+ "header": "linkToPrevious",
104
+ "footer": "linkToPrevious"
105
+ },
27
106
  "children": [
28
- { "name": "heading", "props": { "text": "Introduction", "level": 1 } },
29
- { "name": "paragraph", "props": { "text": "This guide covers the integration of external systems with the Platform API. It is intended for developers and system architects building custom integrations." } },
30
- { "name": "heading", "props": { "text": "Prerequisites", "level": 2 } },
107
+ {
108
+ "name": "heading",
109
+ "props": {
110
+ "text": "Getting Started",
111
+ "level": 1
112
+ }
113
+ },
114
+ {
115
+ "name": "heading",
116
+ "props": {
117
+ "text": "Prerequisites",
118
+ "level": 2
119
+ }
120
+ },
31
121
  {
32
122
  "name": "list",
33
123
  "props": {
34
124
  "format": "bullet",
35
125
  "items": [
36
- "API key with admin scope (Settings > API Keys)",
37
- "Node.js 18+ or Python 3.10+",
38
- "Network access to api.platform.io on port 443",
39
- "Familiarity with REST APIs and OAuth 2.0"
126
+ "Arcline account with API access enabled (Settings > API Keys > Generate)",
127
+ "Node.js 20+ or Python 3.11+ (official SDKs available for both)",
128
+ "Network access to api.arcline.io on port 443 (TLS 1.3 required)",
129
+ "Familiarity with REST APIs, OAuth 2.0 client credentials flow, and webhook architectures"
40
130
  ]
41
131
  }
42
132
  },
43
- { "name": "heading", "props": { "text": "Architecture Overview", "level": 2 } },
44
- { "name": "paragraph", "props": { "text": "The platform exposes a RESTful API organized around resources. All endpoints accept and return JSON. Authentication uses OAuth 2.0 bearer tokens with configurable scopes." } },
133
+ {
134
+ "name": "heading",
135
+ "props": {
136
+ "text": "Architecture Overview",
137
+ "level": 2
138
+ }
139
+ },
140
+ {
141
+ "name": "paragraph",
142
+ "props": {
143
+ "text": "The Arcline Platform exposes a RESTful API organized around resources. All endpoints accept and return JSON. Authentication uses OAuth 2.0 bearer tokens with configurable scopes. Rate limiting is applied per-token with configurable burst allowances."
144
+ }
145
+ },
45
146
  {
46
147
  "name": "image",
47
148
  "props": {
48
- "path": "https://placehold.co/800x400/f1f5f9/475569?text=Architecture+Diagram",
149
+ "path": "https://placehold.co/800x400/F8FAFC/0F172A?text=API+Gateway+%E2%86%92+Auth+Service+%E2%86%92+Microservices+%E2%86%92+Data+Layer&font=helvetica",
49
150
  "width": "100%",
50
- "caption": "Figure 1: High-level architecture showing API gateway, services, and data flow"
151
+ "caption": "Figure 1: High-level architecture API gateway, authentication layer, microservices, and data stores"
152
+ }
153
+ },
154
+ {
155
+ "name": "heading",
156
+ "props": {
157
+ "text": "Base URL & Environments",
158
+ "level": 2
159
+ }
160
+ },
161
+ {
162
+ "name": "table",
163
+ "props": {
164
+ "headerCellDefaults": {
165
+ "font": {
166
+ "bold": true,
167
+ "size": 10
168
+ },
169
+ "padding": {
170
+ "top": 8,
171
+ "right": 10,
172
+ "bottom": 8,
173
+ "left": 10
174
+ }
175
+ },
176
+ "cellDefaults": {
177
+ "padding": {
178
+ "top": 5,
179
+ "right": 10,
180
+ "bottom": 5,
181
+ "left": 10
182
+ },
183
+ "verticalAlignment": "middle",
184
+ "font": {
185
+ "size": 10
186
+ }
187
+ },
188
+ "borderColor": "E2E8F0",
189
+ "borderSize": 1,
190
+ "hideBorders": {
191
+ "insideVertical": true
192
+ },
193
+ "columns": [
194
+ {
195
+ "header": {
196
+ "content": "Environment"
197
+ },
198
+ "cells": [
199
+ {
200
+ "content": "Production"
201
+ },
202
+ {
203
+ "content": "Staging"
204
+ },
205
+ {
206
+ "content": "Sandbox"
207
+ }
208
+ ]
209
+ },
210
+ {
211
+ "header": {
212
+ "content": "Base URL"
213
+ },
214
+ "cells": [
215
+ {
216
+ "content": "https://api.arcline.io/v3",
217
+ "font": {
218
+ "family": "Consolas"
219
+ }
220
+ },
221
+ {
222
+ "content": "https://staging-api.arcline.io/v3",
223
+ "font": {
224
+ "family": "Consolas"
225
+ }
226
+ },
227
+ {
228
+ "content": "https://sandbox-api.arcline.io/v3",
229
+ "font": {
230
+ "family": "Consolas"
231
+ }
232
+ }
233
+ ]
234
+ },
235
+ {
236
+ "header": {
237
+ "content": "Data"
238
+ },
239
+ "cells": [
240
+ {
241
+ "content": "Live production data"
242
+ },
243
+ {
244
+ "content": "Mirror of prod (24h delay)"
245
+ },
246
+ {
247
+ "content": "Synthetic test data"
248
+ }
249
+ ]
250
+ },
251
+ {
252
+ "header": {
253
+ "content": "Rate Limit"
254
+ },
255
+ "cells": [
256
+ {
257
+ "content": "Per plan"
258
+ },
259
+ {
260
+ "content": "50% of plan"
261
+ },
262
+ {
263
+ "content": "Unlimited"
264
+ }
265
+ ]
266
+ }
267
+ ]
268
+ }
269
+ },
270
+ {
271
+ "name": "heading",
272
+ "props": {
273
+ "text": "Quick Start",
274
+ "level": 2
275
+ }
276
+ },
277
+ {
278
+ "name": "paragraph",
279
+ "props": {
280
+ "text": "Install the SDK, configure your credentials, and make your first API call:",
281
+ "font": {
282
+ "bold": true
283
+ }
284
+ }
285
+ },
286
+ {
287
+ "name": "paragraph",
288
+ "props": {
289
+ "text": "npm install @arcline/sdk",
290
+ "font": {
291
+ "family": "Consolas",
292
+ "size": 10
293
+ }
294
+ }
295
+ },
296
+ {
297
+ "name": "paragraph",
298
+ "props": {
299
+ "text": "import { ArclineClient } from '@arcline/sdk';\n\nconst client = new ArclineClient({\n clientId: process.env.ARCLINE_CLIENT_ID,\n clientSecret: process.env.ARCLINE_CLIENT_SECRET,\n});\n\nconst users = await client.users.list({ limit: 10 });\nconsole.log(users.data);",
300
+ "font": {
301
+ "family": "Consolas",
302
+ "size": 10
303
+ }
51
304
  }
52
305
  }
53
306
  ]
54
307
  },
55
308
  {
56
309
  "name": "section",
57
- "props": { "level": 1, "pageBreak": true },
310
+ "props": {
311
+ "level": 1,
312
+ "pageBreak": true,
313
+ "header": "linkToPrevious",
314
+ "footer": "linkToPrevious"
315
+ },
58
316
  "children": [
59
- { "name": "heading", "props": { "text": "Authentication", "level": 1 } },
60
- { "name": "paragraph", "props": { "text": "All API requests require a valid bearer token. Tokens are obtained via the OAuth 2.0 client credentials flow." } },
61
- { "name": "heading", "props": { "text": "Token Exchange", "level": 2 } },
62
- { "name": "paragraph", "props": { "text": "POST /oauth/token with your client_id and client_secret to receive an access token. Tokens expire after 3600 seconds. Include the token in subsequent requests via the Authorization header: Bearer <token>.", "font": { "family": "Courier New" } } },
63
- { "name": "heading", "props": { "text": "Available Scopes", "level": 2 } },
317
+ {
318
+ "name": "heading",
319
+ "props": {
320
+ "text": "Authentication",
321
+ "level": 1
322
+ }
323
+ },
324
+ {
325
+ "name": "paragraph",
326
+ "props": {
327
+ "text": "All API requests require a valid bearer token. Tokens are obtained via the OAuth 2.0 client credentials flow and expire after 3600 seconds (1 hour). The SDK handles token refresh automatically."
328
+ }
329
+ },
330
+ {
331
+ "name": "heading",
332
+ "props": {
333
+ "text": "Token Exchange",
334
+ "level": 2
335
+ }
336
+ },
337
+ {
338
+ "name": "paragraph",
339
+ "props": {
340
+ "text": "Request:",
341
+ "font": {
342
+ "bold": true
343
+ }
344
+ }
345
+ },
346
+ {
347
+ "name": "paragraph",
348
+ "props": {
349
+ "text": "POST https://auth.arcline.io/oauth/token\nContent-Type: application/x-www-form-urlencoded\n\ngrant_type=client_credentials\n&client_id=YOUR_CLIENT_ID\n&client_secret=YOUR_CLIENT_SECRET\n&scope=read:data write:data",
350
+ "font": {
351
+ "family": "Consolas",
352
+ "size": 10
353
+ }
354
+ }
355
+ },
356
+ {
357
+ "name": "paragraph",
358
+ "props": {
359
+ "text": "Response:",
360
+ "font": {
361
+ "bold": true
362
+ }
363
+ }
364
+ },
365
+ {
366
+ "name": "paragraph",
367
+ "props": {
368
+ "text": "{\n \"access_token\": \"eyJhbGciOiJSUzI1NiIs...\",\n \"token_type\": \"Bearer\",\n \"expires_in\": 3600,\n \"scope\": \"read:data write:data\"\n}",
369
+ "font": {
370
+ "family": "Consolas",
371
+ "size": 10
372
+ }
373
+ }
374
+ },
375
+ {
376
+ "name": "paragraph",
377
+ "props": {
378
+ "text": "Include the token in subsequent requests via the Authorization header:",
379
+ "font": {
380
+ "bold": true
381
+ }
382
+ }
383
+ },
384
+ {
385
+ "name": "paragraph",
386
+ "props": {
387
+ "text": "Authorization: Bearer eyJhbGciOiJSUzI1NiIs...",
388
+ "font": {
389
+ "family": "Consolas",
390
+ "size": 10
391
+ }
392
+ }
393
+ },
394
+ {
395
+ "name": "heading",
396
+ "props": {
397
+ "text": "Available Scopes",
398
+ "level": 2
399
+ }
400
+ },
64
401
  {
65
402
  "name": "table",
66
403
  "props": {
404
+ "headerCellDefaults": {
405
+ "font": {
406
+ "bold": true,
407
+ "size": 10
408
+ },
409
+ "padding": {
410
+ "top": 8,
411
+ "right": 10,
412
+ "bottom": 8,
413
+ "left": 10
414
+ }
415
+ },
416
+ "cellDefaults": {
417
+ "padding": {
418
+ "top": 5,
419
+ "right": 10,
420
+ "bottom": 5,
421
+ "left": 10
422
+ },
423
+ "verticalAlignment": "middle",
424
+ "font": {
425
+ "size": 10
426
+ }
427
+ },
428
+ "borderColor": "E2E8F0",
429
+ "borderSize": 1,
430
+ "hideBorders": {
431
+ "insideVertical": true
432
+ },
67
433
  "columns": [
68
- { "header": { "content": "Scope" }, "cells": [{ "content": "read:data" }, { "content": "write:data" }, { "content": "admin:users" }, { "content": "admin:config" }] },
69
- { "header": { "content": "Access Level" }, "cells": [{ "content": "Read-only" }, { "content": "Read/Write" }, { "content": "User management" }, { "content": "Configuration" }] },
70
- { "header": { "content": "Use Case" }, "cells": [{ "content": "Dashboards, reporting" }, { "content": "Data sync, imports" }, { "content": "Provisioning, SCIM" }, { "content": "Settings, webhooks" }] }
434
+ {
435
+ "header": {
436
+ "content": "Scope"
437
+ },
438
+ "cells": [
439
+ {
440
+ "content": "read:data"
441
+ },
442
+ {
443
+ "content": "write:data"
444
+ },
445
+ {
446
+ "content": "read:analytics"
447
+ },
448
+ {
449
+ "content": "admin:users"
450
+ },
451
+ {
452
+ "content": "admin:config"
453
+ },
454
+ {
455
+ "content": "webhooks:manage"
456
+ }
457
+ ]
458
+ },
459
+ {
460
+ "header": {
461
+ "content": "Access Level"
462
+ },
463
+ "cells": [
464
+ {
465
+ "content": "Read-only"
466
+ },
467
+ {
468
+ "content": "Read/Write"
469
+ },
470
+ {
471
+ "content": "Analytics queries"
472
+ },
473
+ {
474
+ "content": "User management"
475
+ },
476
+ {
477
+ "content": "Configuration"
478
+ },
479
+ {
480
+ "content": "Webhook CRUD"
481
+ }
482
+ ]
483
+ },
484
+ {
485
+ "header": {
486
+ "content": "Use Case"
487
+ },
488
+ "cells": [
489
+ {
490
+ "content": "Dashboards, reporting, data sync"
491
+ },
492
+ {
493
+ "content": "Data ingestion, imports, updates"
494
+ },
495
+ {
496
+ "content": "Custom reports, BI integration"
497
+ },
498
+ {
499
+ "content": "Provisioning, SSO/SCIM, RBAC"
500
+ },
501
+ {
502
+ "content": "Settings, feature flags, themes"
503
+ },
504
+ {
505
+ "content": "Event subscriptions, delivery mgmt"
506
+ }
507
+ ]
508
+ },
509
+ {
510
+ "header": {
511
+ "content": "Min Plan"
512
+ },
513
+ "cells": [
514
+ {
515
+ "content": "Free"
516
+ },
517
+ {
518
+ "content": "Pro"
519
+ },
520
+ {
521
+ "content": "Pro"
522
+ },
523
+ {
524
+ "content": "Enterprise"
525
+ },
526
+ {
527
+ "content": "Enterprise"
528
+ },
529
+ {
530
+ "content": "Pro"
531
+ }
532
+ ]
533
+ }
534
+ ]
535
+ }
536
+ },
537
+ {
538
+ "name": "heading",
539
+ "props": {
540
+ "text": "Token Security Best Practices",
541
+ "level": 2
542
+ }
543
+ },
544
+ {
545
+ "name": "list",
546
+ "props": {
547
+ "format": "bullet",
548
+ "items": [
549
+ "Never embed client secrets in client-side code or version control",
550
+ "Use environment variables or a secrets manager (AWS Secrets Manager, HashiCorp Vault)",
551
+ "Rotate client secrets every 90 days — the API supports two active secrets for zero-downtime rotation",
552
+ "Request only the scopes your integration needs (principle of least privilege)",
553
+ "Monitor the /oauth/audit endpoint for unauthorized token requests"
71
554
  ]
72
555
  }
73
556
  }
@@ -75,22 +558,43 @@
75
558
  },
76
559
  {
77
560
  "name": "section",
78
- "props": { "level": 1, "pageBreak": true },
561
+ "props": {
562
+ "level": 1,
563
+ "pageBreak": true,
564
+ "header": "linkToPrevious",
565
+ "footer": "linkToPrevious"
566
+ },
79
567
  "children": [
80
- { "name": "heading", "props": { "text": "API Reference", "level": 1 } },
81
- { "name": "heading", "props": { "text": "Resources", "level": 2 } },
568
+ {
569
+ "name": "heading",
570
+ "props": {
571
+ "text": "API Reference",
572
+ "level": 1
573
+ }
574
+ },
575
+ {
576
+ "name": "heading",
577
+ "props": {
578
+ "text": "Resource Endpoints",
579
+ "level": 2
580
+ }
581
+ },
82
582
  {
83
583
  "name": "columns",
84
- "props": { "columns": 2, "gap": 0.5 },
584
+ "props": {
585
+ "columns": 2,
586
+ "gap": 0.5
587
+ },
85
588
  "children": [
86
589
  {
87
590
  "name": "list",
88
591
  "props": {
89
592
  "format": "bullet",
90
593
  "items": [
91
- "/users — User management",
92
- "/teams — Team operations",
93
- "/projects — Project CRUD",
594
+ "/users — User management and profiles",
595
+ "/teams — Team operations and membership",
596
+ "/projects — Project CRUD and permissions",
597
+ "/pipelines — Data pipeline orchestration",
94
598
  "/webhooks — Event subscriptions"
95
599
  ]
96
600
  }
@@ -100,42 +604,356 @@
100
604
  "props": {
101
605
  "format": "bullet",
102
606
  "items": [
103
- "/events — Activity log",
104
- "/files — File storage",
105
- "/search — Full-text search",
106
- "/analytics — Usage metrics"
607
+ "/events — Activity log and audit trail",
608
+ "/files — File storage and versioning",
609
+ "/search — Full-text search across resources",
610
+ "/analytics — Usage metrics and custom queries",
611
+ "/exports — Scheduled data exports"
107
612
  ]
108
613
  }
109
614
  }
110
615
  ]
111
616
  },
112
- { "name": "heading", "props": { "text": "Rate Limits", "level": 2 } },
113
- { "name": "paragraph", "props": { "text": "API requests are rate-limited per token. Exceeding the limit returns HTTP 429. Use the Retry-After header to determine when to retry." } },
617
+ {
618
+ "name": "heading",
619
+ "props": {
620
+ "text": "Common Operations",
621
+ "level": 2
622
+ }
623
+ },
114
624
  {
115
625
  "name": "table",
116
626
  "props": {
627
+ "headerCellDefaults": {
628
+ "font": {
629
+ "bold": true,
630
+ "size": 10
631
+ },
632
+ "padding": {
633
+ "top": 8,
634
+ "right": 10,
635
+ "bottom": 8,
636
+ "left": 10
637
+ }
638
+ },
639
+ "cellDefaults": {
640
+ "padding": {
641
+ "top": 5,
642
+ "right": 10,
643
+ "bottom": 5,
644
+ "left": 10
645
+ },
646
+ "verticalAlignment": "middle",
647
+ "font": {
648
+ "size": 10
649
+ }
650
+ },
651
+ "borderColor": "E2E8F0",
652
+ "borderSize": 1,
653
+ "hideBorders": {
654
+ "insideVertical": true
655
+ },
117
656
  "columns": [
118
- { "header": { "content": "Plan" }, "cells": [{ "content": "Free" }, { "content": "Pro" }, { "content": "Enterprise" }] },
119
- { "header": { "content": "Requests/min" }, "cells": [{ "content": "60" }, { "content": "600" }, { "content": "6,000" }] },
120
- { "header": { "content": "Burst" }, "cells": [{ "content": "10" }, { "content": "100" }, { "content": "1,000" }] },
121
- { "header": { "content": "Concurrent" }, "cells": [{ "content": "5" }, { "content": "25" }, { "content": "100" }] }
122
- ],
123
- "headerCellDefaults": { "backgroundColor": "#1F2937", "color": "#FFFFFF" }
657
+ {
658
+ "header": {
659
+ "content": "Operation"
660
+ },
661
+ "cells": [
662
+ {
663
+ "content": "List resources"
664
+ },
665
+ {
666
+ "content": "Get single resource"
667
+ },
668
+ {
669
+ "content": "Create resource"
670
+ },
671
+ {
672
+ "content": "Update resource"
673
+ },
674
+ {
675
+ "content": "Delete resource"
676
+ },
677
+ {
678
+ "content": "Batch operations"
679
+ }
680
+ ]
681
+ },
682
+ {
683
+ "header": {
684
+ "content": "Method"
685
+ },
686
+ "cells": [
687
+ {
688
+ "content": "GET",
689
+ "font": {
690
+ "family": "Consolas"
691
+ }
692
+ },
693
+ {
694
+ "content": "GET",
695
+ "font": {
696
+ "family": "Consolas"
697
+ }
698
+ },
699
+ {
700
+ "content": "POST",
701
+ "font": {
702
+ "family": "Consolas"
703
+ }
704
+ },
705
+ {
706
+ "content": "PATCH",
707
+ "font": {
708
+ "family": "Consolas"
709
+ }
710
+ },
711
+ {
712
+ "content": "DELETE",
713
+ "font": {
714
+ "family": "Consolas"
715
+ }
716
+ },
717
+ {
718
+ "content": "POST",
719
+ "font": {
720
+ "family": "Consolas"
721
+ }
722
+ }
723
+ ]
724
+ },
725
+ {
726
+ "header": {
727
+ "content": "Path"
728
+ },
729
+ "cells": [
730
+ {
731
+ "content": "/{resource}",
732
+ "font": {
733
+ "family": "Consolas"
734
+ }
735
+ },
736
+ {
737
+ "content": "/{resource}/{id}",
738
+ "font": {
739
+ "family": "Consolas"
740
+ }
741
+ },
742
+ {
743
+ "content": "/{resource}",
744
+ "font": {
745
+ "family": "Consolas"
746
+ }
747
+ },
748
+ {
749
+ "content": "/{resource}/{id}",
750
+ "font": {
751
+ "family": "Consolas"
752
+ }
753
+ },
754
+ {
755
+ "content": "/{resource}/{id}",
756
+ "font": {
757
+ "family": "Consolas"
758
+ }
759
+ },
760
+ {
761
+ "content": "/{resource}/batch",
762
+ "font": {
763
+ "family": "Consolas"
764
+ }
765
+ }
766
+ ]
767
+ },
768
+ {
769
+ "header": {
770
+ "content": "Notes"
771
+ },
772
+ "cells": [
773
+ {
774
+ "content": "Supports ?limit, ?offset, ?sort, ?filter"
775
+ },
776
+ {
777
+ "content": "Returns 404 if not found"
778
+ },
779
+ {
780
+ "content": "Returns 201 with Location header"
781
+ },
782
+ {
783
+ "content": "Partial updates (merge semantics)"
784
+ },
785
+ {
786
+ "content": "Returns 204 No Content"
787
+ },
788
+ {
789
+ "content": "Up to 100 operations per request"
790
+ }
791
+ ]
792
+ }
793
+ ]
124
794
  }
125
795
  },
126
- { "name": "heading", "props": { "text": "Error Handling", "level": 2 } },
127
- { "name": "paragraph", "props": { "text": "The API uses standard HTTP status codes. All error responses include a JSON body with code, message, and request_id fields. Common errors:" } },
128
796
  {
129
- "name": "list",
797
+ "name": "heading",
130
798
  "props": {
131
- "format": "bullet",
132
- "items": [
133
- "400 Bad Request — Invalid parameters or malformed JSON",
134
- "401 Unauthorized — Missing or expired token",
135
- "403 Forbidden — Insufficient scope for the requested operation",
136
- "404 Not Found — Resource does not exist",
137
- "429 Too Many Requests — Rate limit exceeded",
138
- "500 Internal Server Error Unexpected server failure (include request_id in support tickets)"
799
+ "text": "Pagination",
800
+ "level": 2
801
+ }
802
+ },
803
+ {
804
+ "name": "paragraph",
805
+ "props": {
806
+ "text": "All list endpoints support cursor-based pagination. The response includes a meta object with pagination details:",
807
+ "font": {
808
+ "bold": true
809
+ }
810
+ }
811
+ },
812
+ {
813
+ "name": "paragraph",
814
+ "props": {
815
+ "text": "{\n \"data\": [...],\n \"meta\": {\n \"total\": 1247,\n \"limit\": 25,\n \"has_more\": true,\n \"next_cursor\": \"eyJpZCI6MTI0N30=\"\n }\n}",
816
+ "font": {
817
+ "family": "Consolas",
818
+ "size": 10
819
+ }
820
+ }
821
+ },
822
+ {
823
+ "name": "paragraph",
824
+ "props": {
825
+ "text": "Pass the next_cursor value as the ?cursor query parameter to fetch the next page. Maximum limit is 100 items per request.",
826
+ "font": {
827
+ "color": "textSecondary"
828
+ }
829
+ }
830
+ },
831
+ {
832
+ "name": "heading",
833
+ "props": {
834
+ "text": "Rate Limits",
835
+ "level": 2
836
+ }
837
+ },
838
+ {
839
+ "name": "paragraph",
840
+ "props": {
841
+ "text": "API requests are rate-limited per token. Exceeding the limit returns HTTP 429 Too Many Requests. Use the Retry-After header (in seconds) to determine when to retry. The SDK handles retries with exponential backoff automatically."
842
+ }
843
+ },
844
+ {
845
+ "name": "table",
846
+ "props": {
847
+ "headerCellDefaults": {
848
+ "font": {
849
+ "bold": true,
850
+ "size": 10
851
+ },
852
+ "padding": {
853
+ "top": 8,
854
+ "right": 10,
855
+ "bottom": 8,
856
+ "left": 10
857
+ }
858
+ },
859
+ "cellDefaults": {
860
+ "padding": {
861
+ "top": 5,
862
+ "right": 10,
863
+ "bottom": 5,
864
+ "left": 10
865
+ },
866
+ "verticalAlignment": "middle",
867
+ "font": {
868
+ "size": 10
869
+ }
870
+ },
871
+ "borderColor": "E2E8F0",
872
+ "borderSize": 1,
873
+ "hideBorders": {
874
+ "insideVertical": true
875
+ },
876
+ "columns": [
877
+ {
878
+ "header": {
879
+ "content": "Plan"
880
+ },
881
+ "cells": [
882
+ {
883
+ "content": "Free"
884
+ },
885
+ {
886
+ "content": "Pro"
887
+ },
888
+ {
889
+ "content": "Enterprise"
890
+ }
891
+ ]
892
+ },
893
+ {
894
+ "header": {
895
+ "content": "Requests/min"
896
+ },
897
+ "cells": [
898
+ {
899
+ "content": "60"
900
+ },
901
+ {
902
+ "content": "600"
903
+ },
904
+ {
905
+ "content": "6,000"
906
+ }
907
+ ]
908
+ },
909
+ {
910
+ "header": {
911
+ "content": "Burst"
912
+ },
913
+ "cells": [
914
+ {
915
+ "content": "10"
916
+ },
917
+ {
918
+ "content": "100"
919
+ },
920
+ {
921
+ "content": "1,000"
922
+ }
923
+ ]
924
+ },
925
+ {
926
+ "header": {
927
+ "content": "Concurrent"
928
+ },
929
+ "cells": [
930
+ {
931
+ "content": "5"
932
+ },
933
+ {
934
+ "content": "25"
935
+ },
936
+ {
937
+ "content": "100"
938
+ }
939
+ ]
940
+ },
941
+ {
942
+ "header": {
943
+ "content": "Daily Quota"
944
+ },
945
+ "cells": [
946
+ {
947
+ "content": "10,000"
948
+ },
949
+ {
950
+ "content": "500,000"
951
+ },
952
+ {
953
+ "content": "Unlimited"
954
+ }
955
+ ]
956
+ }
139
957
  ]
140
958
  }
141
959
  }
@@ -143,30 +961,826 @@
143
961
  },
144
962
  {
145
963
  "name": "section",
146
- "props": { "level": 1, "pageBreak": true },
964
+ "props": {
965
+ "level": 1,
966
+ "pageBreak": true,
967
+ "header": "linkToPrevious",
968
+ "footer": "linkToPrevious"
969
+ },
147
970
  "children": [
148
- { "name": "heading", "props": { "text": "Webhooks", "level": 1 } },
149
- { "name": "paragraph", "props": { "text": "Webhooks deliver real-time event notifications to your endpoint via HTTP POST. Configure webhooks in the dashboard or via the /webhooks API. All payloads are signed with HMAC-SHA256." } },
150
- { "name": "heading", "props": { "text": "Supported Events", "level": 2 } },
971
+ {
972
+ "name": "heading",
973
+ "props": {
974
+ "text": "Webhooks",
975
+ "level": 1
976
+ }
977
+ },
978
+ {
979
+ "name": "paragraph",
980
+ "props": {
981
+ "text": "Webhooks deliver real-time event notifications to your endpoint via HTTP POST. Configure webhooks in the dashboard (Settings > Webhooks) or via the /webhooks API. All payloads are signed with HMAC-SHA256 using your webhook secret for verification."
982
+ }
983
+ },
984
+ {
985
+ "name": "heading",
986
+ "props": {
987
+ "text": "Supported Events",
988
+ "level": 2
989
+ }
990
+ },
151
991
  {
152
992
  "name": "columns",
153
- "props": { "columns": 2 },
993
+ "props": {
994
+ "columns": 2
995
+ },
154
996
  "children": [
155
997
  {
156
998
  "name": "table",
157
999
  "props": {
1000
+ "headerCellDefaults": {
1001
+ "font": {
1002
+ "bold": true,
1003
+ "size": 9
1004
+ },
1005
+ "padding": {
1006
+ "top": 6,
1007
+ "right": 8,
1008
+ "bottom": 6,
1009
+ "left": 8
1010
+ }
1011
+ },
1012
+ "cellDefaults": {
1013
+ "padding": {
1014
+ "top": 4,
1015
+ "right": 8,
1016
+ "bottom": 4,
1017
+ "left": 8
1018
+ },
1019
+ "verticalAlignment": "middle",
1020
+ "font": {
1021
+ "size": 9
1022
+ }
1023
+ },
1024
+ "borderColor": "E2E8F0",
1025
+ "borderSize": 1,
1026
+ "hideBorders": {
1027
+ "insideVertical": true
1028
+ },
158
1029
  "columns": [
159
- { "header": { "content": "Event" }, "cells": [{ "content": "user.created" }, { "content": "user.updated" }, { "content": "project.created" }, { "content": "project.archived" }] },
160
- { "header": { "content": "Trigger" }, "cells": [{ "content": "New user signup" }, { "content": "Profile change" }, { "content": "New project" }, { "content": "Project archived" }] }
1030
+ {
1031
+ "header": {
1032
+ "content": "Event"
1033
+ },
1034
+ "cells": [
1035
+ {
1036
+ "content": "user.created"
1037
+ },
1038
+ {
1039
+ "content": "user.updated"
1040
+ },
1041
+ {
1042
+ "content": "user.deleted"
1043
+ },
1044
+ {
1045
+ "content": "project.created"
1046
+ },
1047
+ {
1048
+ "content": "project.archived"
1049
+ },
1050
+ {
1051
+ "content": "pipeline.completed"
1052
+ }
1053
+ ]
1054
+ },
1055
+ {
1056
+ "header": {
1057
+ "content": "Trigger"
1058
+ },
1059
+ "cells": [
1060
+ {
1061
+ "content": "New user signup or SSO provision"
1062
+ },
1063
+ {
1064
+ "content": "Profile or permission change"
1065
+ },
1066
+ {
1067
+ "content": "Account deactivation"
1068
+ },
1069
+ {
1070
+ "content": "New project created"
1071
+ },
1072
+ {
1073
+ "content": "Project archived by owner"
1074
+ },
1075
+ {
1076
+ "content": "Pipeline run finished"
1077
+ }
1078
+ ]
1079
+ }
161
1080
  ]
162
1081
  }
163
1082
  },
164
1083
  {
165
1084
  "name": "table",
166
1085
  "props": {
1086
+ "headerCellDefaults": {
1087
+ "font": {
1088
+ "bold": true,
1089
+ "size": 9
1090
+ },
1091
+ "padding": {
1092
+ "top": 6,
1093
+ "right": 8,
1094
+ "bottom": 6,
1095
+ "left": 8
1096
+ }
1097
+ },
1098
+ "cellDefaults": {
1099
+ "padding": {
1100
+ "top": 4,
1101
+ "right": 8,
1102
+ "bottom": 4,
1103
+ "left": 8
1104
+ },
1105
+ "verticalAlignment": "middle",
1106
+ "font": {
1107
+ "size": 9
1108
+ }
1109
+ },
1110
+ "borderColor": "E2E8F0",
1111
+ "borderSize": 1,
1112
+ "hideBorders": {
1113
+ "insideVertical": true
1114
+ },
167
1115
  "columns": [
168
- { "header": { "content": "Event" }, "cells": [{ "content": "file.uploaded" }, { "content": "file.deleted" }, { "content": "team.member_added" }, { "content": "billing.invoice" }] },
169
- { "header": { "content": "Trigger" }, "cells": [{ "content": "New file" }, { "content": "File removed" }, { "content": "User joins team" }, { "content": "Invoice generated" }] }
1116
+ {
1117
+ "header": {
1118
+ "content": "Event"
1119
+ },
1120
+ "cells": [
1121
+ {
1122
+ "content": "pipeline.failed"
1123
+ },
1124
+ {
1125
+ "content": "file.uploaded"
1126
+ },
1127
+ {
1128
+ "content": "file.deleted"
1129
+ },
1130
+ {
1131
+ "content": "team.member_added"
1132
+ },
1133
+ {
1134
+ "content": "billing.invoice"
1135
+ },
1136
+ {
1137
+ "content": "export.ready"
1138
+ }
1139
+ ]
1140
+ },
1141
+ {
1142
+ "header": {
1143
+ "content": "Trigger"
1144
+ },
1145
+ "cells": [
1146
+ {
1147
+ "content": "Pipeline run errored"
1148
+ },
1149
+ {
1150
+ "content": "New file uploaded"
1151
+ },
1152
+ {
1153
+ "content": "File permanently removed"
1154
+ },
1155
+ {
1156
+ "content": "User added to team"
1157
+ },
1158
+ {
1159
+ "content": "Monthly invoice generated"
1160
+ },
1161
+ {
1162
+ "content": "Scheduled export completed"
1163
+ }
1164
+ ]
1165
+ }
1166
+ ]
1167
+ }
1168
+ }
1169
+ ]
1170
+ },
1171
+ {
1172
+ "name": "heading",
1173
+ "props": {
1174
+ "text": "Payload Structure",
1175
+ "level": 2
1176
+ }
1177
+ },
1178
+ {
1179
+ "name": "paragraph",
1180
+ "props": {
1181
+ "text": "Every webhook delivery includes the following envelope:",
1182
+ "font": {
1183
+ "bold": true
1184
+ }
1185
+ }
1186
+ },
1187
+ {
1188
+ "name": "paragraph",
1189
+ "props": {
1190
+ "text": "{\n \"id\": \"evt_a1b2c3d4e5\",\n \"type\": \"user.created\",\n \"created_at\": \"2026-04-01T14:30:00Z\",\n \"data\": { ... },\n \"metadata\": {\n \"delivery_id\": \"dlv_x9y8z7\",\n \"attempt\": 1,\n \"webhook_id\": \"whk_m4n5o6\"\n }\n}",
1191
+ "font": {
1192
+ "family": "Consolas",
1193
+ "size": 10
1194
+ }
1195
+ }
1196
+ },
1197
+ {
1198
+ "name": "heading",
1199
+ "props": {
1200
+ "text": "Signature Verification",
1201
+ "level": 2
1202
+ }
1203
+ },
1204
+ {
1205
+ "name": "paragraph",
1206
+ "props": {
1207
+ "text": "Verify the X-Arcline-Signature header to ensure the payload was sent by Arcline and has not been tampered with:",
1208
+ "font": {
1209
+ "bold": true
1210
+ }
1211
+ }
1212
+ },
1213
+ {
1214
+ "name": "paragraph",
1215
+ "props": {
1216
+ "text": "import crypto from 'crypto';\n\nfunction verifySignature(payload, signature, secret) {\n const expected = crypto\n .createHmac('sha256', secret)\n .update(payload)\n .digest('hex');\n return crypto.timingSafeEqual(\n Buffer.from(signature),\n Buffer.from(expected)\n );\n}",
1217
+ "font": {
1218
+ "family": "Consolas",
1219
+ "size": 10
1220
+ }
1221
+ }
1222
+ },
1223
+ {
1224
+ "name": "heading",
1225
+ "props": {
1226
+ "text": "Retry Policy",
1227
+ "level": 2
1228
+ }
1229
+ },
1230
+ {
1231
+ "name": "paragraph",
1232
+ "props": {
1233
+ "text": "Failed deliveries (non-2xx response or timeout after 30 seconds) are retried with exponential backoff:"
1234
+ }
1235
+ },
1236
+ {
1237
+ "name": "table",
1238
+ "props": {
1239
+ "headerCellDefaults": {
1240
+ "font": {
1241
+ "bold": true,
1242
+ "size": 10
1243
+ },
1244
+ "padding": {
1245
+ "top": 8,
1246
+ "right": 10,
1247
+ "bottom": 8,
1248
+ "left": 10
1249
+ }
1250
+ },
1251
+ "cellDefaults": {
1252
+ "padding": {
1253
+ "top": 5,
1254
+ "right": 10,
1255
+ "bottom": 5,
1256
+ "left": 10
1257
+ },
1258
+ "verticalAlignment": "middle",
1259
+ "font": {
1260
+ "size": 10
1261
+ }
1262
+ },
1263
+ "borderColor": "E2E8F0",
1264
+ "borderSize": 1,
1265
+ "hideBorders": {
1266
+ "insideVertical": true
1267
+ },
1268
+ "columns": [
1269
+ {
1270
+ "header": {
1271
+ "content": "Attempt"
1272
+ },
1273
+ "cells": [
1274
+ {
1275
+ "content": "1st retry"
1276
+ },
1277
+ {
1278
+ "content": "2nd retry"
1279
+ },
1280
+ {
1281
+ "content": "3rd retry"
1282
+ },
1283
+ {
1284
+ "content": "4th retry"
1285
+ },
1286
+ {
1287
+ "content": "5th retry (final)"
1288
+ }
1289
+ ]
1290
+ },
1291
+ {
1292
+ "header": {
1293
+ "content": "Delay"
1294
+ },
1295
+ "cells": [
1296
+ {
1297
+ "content": "1 minute"
1298
+ },
1299
+ {
1300
+ "content": "5 minutes"
1301
+ },
1302
+ {
1303
+ "content": "30 minutes"
1304
+ },
1305
+ {
1306
+ "content": "2 hours"
1307
+ },
1308
+ {
1309
+ "content": "24 hours"
1310
+ }
1311
+ ]
1312
+ },
1313
+ {
1314
+ "header": {
1315
+ "content": "Cumulative"
1316
+ },
1317
+ "cells": [
1318
+ {
1319
+ "content": "~1 min"
1320
+ },
1321
+ {
1322
+ "content": "~6 min"
1323
+ },
1324
+ {
1325
+ "content": "~36 min"
1326
+ },
1327
+ {
1328
+ "content": "~2.5 hours"
1329
+ },
1330
+ {
1331
+ "content": "~26.5 hours"
1332
+ }
1333
+ ]
1334
+ }
1335
+ ]
1336
+ }
1337
+ },
1338
+ {
1339
+ "name": "paragraph",
1340
+ "props": {
1341
+ "text": "After 5 failed attempts, the event is marked as failed and visible in the dashboard. Webhooks with > 95% failure rate over 48 hours are automatically disabled with an email notification to the account owner."
1342
+ }
1343
+ }
1344
+ ]
1345
+ },
1346
+ {
1347
+ "name": "section",
1348
+ "props": {
1349
+ "level": 1,
1350
+ "pageBreak": true,
1351
+ "header": "linkToPrevious",
1352
+ "footer": "linkToPrevious"
1353
+ },
1354
+ "children": [
1355
+ {
1356
+ "name": "heading",
1357
+ "props": {
1358
+ "text": "Error Handling",
1359
+ "level": 1
1360
+ }
1361
+ },
1362
+ {
1363
+ "name": "paragraph",
1364
+ "props": {
1365
+ "text": "The API uses standard HTTP status codes. All error responses include a JSON body with code, message, request_id, and optional details fields."
1366
+ }
1367
+ },
1368
+ {
1369
+ "name": "heading",
1370
+ "props": {
1371
+ "text": "Error Response Format",
1372
+ "level": 2
1373
+ }
1374
+ },
1375
+ {
1376
+ "name": "paragraph",
1377
+ "props": {
1378
+ "text": "{\n \"error\": {\n \"code\": \"validation_error\",\n \"message\": \"Invalid request parameters\",\n \"request_id\": \"req_abc123\",\n \"details\": [\n { \"field\": \"email\", \"message\": \"must be a valid email address\" }\n ]\n }\n}",
1379
+ "font": {
1380
+ "family": "Consolas",
1381
+ "size": 10
1382
+ }
1383
+ }
1384
+ },
1385
+ {
1386
+ "name": "heading",
1387
+ "props": {
1388
+ "text": "Status Code Reference",
1389
+ "level": 2
1390
+ }
1391
+ },
1392
+ {
1393
+ "name": "table",
1394
+ "props": {
1395
+ "headerCellDefaults": {
1396
+ "font": {
1397
+ "bold": true,
1398
+ "size": 10
1399
+ },
1400
+ "padding": {
1401
+ "top": 8,
1402
+ "right": 10,
1403
+ "bottom": 8,
1404
+ "left": 10
1405
+ }
1406
+ },
1407
+ "cellDefaults": {
1408
+ "padding": {
1409
+ "top": 5,
1410
+ "right": 10,
1411
+ "bottom": 5,
1412
+ "left": 10
1413
+ },
1414
+ "verticalAlignment": "middle",
1415
+ "font": {
1416
+ "size": 10
1417
+ }
1418
+ },
1419
+ "borderColor": "E2E8F0",
1420
+ "borderSize": 1,
1421
+ "hideBorders": {
1422
+ "insideVertical": true
1423
+ },
1424
+ "columns": [
1425
+ {
1426
+ "header": {
1427
+ "content": "Code"
1428
+ },
1429
+ "cells": [
1430
+ {
1431
+ "content": "400"
1432
+ },
1433
+ {
1434
+ "content": "401"
1435
+ },
1436
+ {
1437
+ "content": "403"
1438
+ },
1439
+ {
1440
+ "content": "404"
1441
+ },
1442
+ {
1443
+ "content": "409"
1444
+ },
1445
+ {
1446
+ "content": "422"
1447
+ },
1448
+ {
1449
+ "content": "429"
1450
+ },
1451
+ {
1452
+ "content": "500"
1453
+ },
1454
+ {
1455
+ "content": "503"
1456
+ }
1457
+ ]
1458
+ },
1459
+ {
1460
+ "header": {
1461
+ "content": "Meaning"
1462
+ },
1463
+ "cells": [
1464
+ {
1465
+ "content": "Bad Request"
1466
+ },
1467
+ {
1468
+ "content": "Unauthorized"
1469
+ },
1470
+ {
1471
+ "content": "Forbidden"
1472
+ },
1473
+ {
1474
+ "content": "Not Found"
1475
+ },
1476
+ {
1477
+ "content": "Conflict"
1478
+ },
1479
+ {
1480
+ "content": "Unprocessable Entity"
1481
+ },
1482
+ {
1483
+ "content": "Rate Limited"
1484
+ },
1485
+ {
1486
+ "content": "Internal Error"
1487
+ },
1488
+ {
1489
+ "content": "Service Unavailable"
1490
+ }
1491
+ ]
1492
+ },
1493
+ {
1494
+ "header": {
1495
+ "content": "Common Cause"
1496
+ },
1497
+ "cells": [
1498
+ {
1499
+ "content": "Malformed JSON or invalid query parameters"
1500
+ },
1501
+ {
1502
+ "content": "Missing or expired bearer token"
1503
+ },
1504
+ {
1505
+ "content": "Insufficient scope for the operation"
1506
+ },
1507
+ {
1508
+ "content": "Resource does not exist or was deleted"
1509
+ },
1510
+ {
1511
+ "content": "Duplicate resource or concurrent modification"
1512
+ },
1513
+ {
1514
+ "content": "Valid JSON but semantic validation failed"
1515
+ },
1516
+ {
1517
+ "content": "Rate limit exceeded — check Retry-After header"
1518
+ },
1519
+ {
1520
+ "content": "Unexpected server error — include request_id in support tickets"
1521
+ },
1522
+ {
1523
+ "content": "Temporary outage — retry with backoff"
1524
+ }
1525
+ ]
1526
+ },
1527
+ {
1528
+ "header": {
1529
+ "content": "Retryable?"
1530
+ },
1531
+ "cells": [
1532
+ {
1533
+ "content": "No"
1534
+ },
1535
+ {
1536
+ "content": "No (refresh token)"
1537
+ },
1538
+ {
1539
+ "content": "No"
1540
+ },
1541
+ {
1542
+ "content": "No"
1543
+ },
1544
+ {
1545
+ "content": "Maybe"
1546
+ },
1547
+ {
1548
+ "content": "No (fix input)"
1549
+ },
1550
+ {
1551
+ "content": "Yes"
1552
+ },
1553
+ {
1554
+ "content": "Yes"
1555
+ },
1556
+ {
1557
+ "content": "Yes"
1558
+ }
1559
+ ]
1560
+ }
1561
+ ]
1562
+ }
1563
+ },
1564
+ {
1565
+ "name": "heading",
1566
+ "props": {
1567
+ "text": "Idempotency",
1568
+ "level": 2
1569
+ }
1570
+ },
1571
+ {
1572
+ "name": "paragraph",
1573
+ "props": {
1574
+ "text": "For POST and PATCH requests, include an Idempotency-Key header to safely retry failed requests without creating duplicates:",
1575
+ "font": {
1576
+ "bold": true
1577
+ }
1578
+ }
1579
+ },
1580
+ {
1581
+ "name": "paragraph",
1582
+ "props": {
1583
+ "text": "POST /v3/users\nIdempotency-Key: idk_unique-request-id-12345\nContent-Type: application/json\n\n{ \"email\": \"jane@example.com\", \"name\": \"Jane Doe\" }",
1584
+ "font": {
1585
+ "family": "Consolas",
1586
+ "size": 10
1587
+ }
1588
+ }
1589
+ },
1590
+ {
1591
+ "name": "paragraph",
1592
+ "props": {
1593
+ "text": "Idempotency keys are valid for 24 hours. Replayed requests within this window return the original response without executing the operation again."
1594
+ }
1595
+ }
1596
+ ]
1597
+ },
1598
+ {
1599
+ "name": "section",
1600
+ "props": {
1601
+ "level": 1,
1602
+ "pageBreak": true,
1603
+ "header": "linkToPrevious",
1604
+ "footer": "linkToPrevious"
1605
+ },
1606
+ "children": [
1607
+ {
1608
+ "name": "heading",
1609
+ "props": {
1610
+ "text": "Troubleshooting",
1611
+ "level": 1
1612
+ }
1613
+ },
1614
+ {
1615
+ "name": "heading",
1616
+ "props": {
1617
+ "text": "Common Issues",
1618
+ "level": 2
1619
+ }
1620
+ },
1621
+ {
1622
+ "name": "table",
1623
+ "props": {
1624
+ "headerCellDefaults": {
1625
+ "font": {
1626
+ "bold": true,
1627
+ "size": 10
1628
+ },
1629
+ "padding": {
1630
+ "top": 8,
1631
+ "right": 10,
1632
+ "bottom": 8,
1633
+ "left": 10
1634
+ }
1635
+ },
1636
+ "cellDefaults": {
1637
+ "padding": {
1638
+ "top": 5,
1639
+ "right": 10,
1640
+ "bottom": 5,
1641
+ "left": 10
1642
+ },
1643
+ "verticalAlignment": "middle",
1644
+ "font": {
1645
+ "size": 10
1646
+ }
1647
+ },
1648
+ "borderColor": "E2E8F0",
1649
+ "borderSize": 1,
1650
+ "hideBorders": {
1651
+ "insideVertical": true
1652
+ },
1653
+ "columns": [
1654
+ {
1655
+ "header": {
1656
+ "content": "Symptom"
1657
+ },
1658
+ "cells": [
1659
+ {
1660
+ "content": "401 on every request"
1661
+ },
1662
+ {
1663
+ "content": "Webhook not firing"
1664
+ },
1665
+ {
1666
+ "content": "Slow list queries"
1667
+ },
1668
+ {
1669
+ "content": "Missing data in responses"
1670
+ },
1671
+ {
1672
+ "content": "CORS errors in browser"
1673
+ }
1674
+ ]
1675
+ },
1676
+ {
1677
+ "header": {
1678
+ "content": "Likely Cause"
1679
+ },
1680
+ "cells": [
1681
+ {
1682
+ "content": "Expired or malformed token"
1683
+ },
1684
+ {
1685
+ "content": "Endpoint unreachable or auto-disabled"
1686
+ },
1687
+ {
1688
+ "content": "Missing index on filter field"
1689
+ },
1690
+ {
1691
+ "content": "Insufficient scope on token"
1692
+ },
1693
+ {
1694
+ "content": "Origin not in allowed list"
1695
+ }
1696
+ ]
1697
+ },
1698
+ {
1699
+ "header": {
1700
+ "content": "Resolution"
1701
+ },
1702
+ "cells": [
1703
+ {
1704
+ "content": "Refresh token; verify client_id/secret; check clock skew < 60s"
1705
+ },
1706
+ {
1707
+ "content": "Check dashboard > Webhooks > Delivery Log; re-enable if disabled"
1708
+ },
1709
+ {
1710
+ "content": "Use ?limit to reduce page size; add ?fields to select specific columns"
1711
+ },
1712
+ {
1713
+ "content": "Re-issue token with required scopes; check admin:users for user data"
1714
+ },
1715
+ {
1716
+ "content": "Add your domain in Settings > API Keys > Allowed Origins"
1717
+ }
1718
+ ]
1719
+ }
1720
+ ]
1721
+ }
1722
+ },
1723
+ {
1724
+ "name": "heading",
1725
+ "props": {
1726
+ "text": "Debug Mode",
1727
+ "level": 2
1728
+ }
1729
+ },
1730
+ {
1731
+ "name": "paragraph",
1732
+ "props": {
1733
+ "text": "Enable verbose logging in the SDK to inspect request/response details:",
1734
+ "font": {
1735
+ "bold": true
1736
+ }
1737
+ }
1738
+ },
1739
+ {
1740
+ "name": "paragraph",
1741
+ "props": {
1742
+ "text": "const client = new ArclineClient({\n clientId: process.env.ARCLINE_CLIENT_ID,\n clientSecret: process.env.ARCLINE_CLIENT_SECRET,\n debug: true, // Logs full request/response to stdout\n timeout: 30000, // 30s timeout (default: 15s)\n});",
1743
+ "font": {
1744
+ "family": "Consolas",
1745
+ "size": 10
1746
+ }
1747
+ }
1748
+ },
1749
+ {
1750
+ "name": "heading",
1751
+ "props": {
1752
+ "text": "Support & Resources",
1753
+ "level": 2
1754
+ }
1755
+ },
1756
+ {
1757
+ "name": "columns",
1758
+ "props": {
1759
+ "columns": 2,
1760
+ "gap": 0.5
1761
+ },
1762
+ "children": [
1763
+ {
1764
+ "name": "list",
1765
+ "props": {
1766
+ "format": "bullet",
1767
+ "items": [
1768
+ "API Status: status.arcline.io",
1769
+ "Developer Docs: docs.arcline.io",
1770
+ "SDK Source: github.com/arcline/sdk",
1771
+ "Community: community.arcline.io"
1772
+ ]
1773
+ }
1774
+ },
1775
+ {
1776
+ "name": "list",
1777
+ "props": {
1778
+ "format": "bullet",
1779
+ "items": [
1780
+ "Email: support@arcline.io",
1781
+ "Enterprise Support: 24/7 Slack channel",
1782
+ "Office Hours: Thursdays 2-3pm PT",
1783
+ "Security: security@arcline.io (PGP key on docs)"
170
1784
  ]
171
1785
  }
172
1786
  }