@voyant-travel/openapi 0.2.5 → 0.3.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 (41) hide show
  1. package/package.json +8 -5
  2. package/spec/admin/accommodations.json +1395 -0
  3. package/spec/admin/action-ledger.json +6202 -0
  4. package/spec/admin/booking-requirements.json +5689 -0
  5. package/spec/admin/bookings.json +18794 -0
  6. package/spec/admin/catalog.json +690 -0
  7. package/spec/admin/distribution.json +19581 -0
  8. package/spec/admin/external-refs.json +1382 -0
  9. package/spec/admin/extras.json +4648 -0
  10. package/spec/admin/finance.json +35506 -0
  11. package/spec/admin/identity.json +4072 -0
  12. package/spec/admin/legal.json +14339 -0
  13. package/spec/admin/markets.json +5286 -0
  14. package/spec/admin/notifications.json +8409 -0
  15. package/spec/admin/operations.json +39806 -0
  16. package/spec/admin/operator-settings.json +1389 -0
  17. package/spec/admin/pricing.json +10640 -0
  18. package/spec/admin/products.json +22131 -0
  19. package/spec/admin/promotions.json +2730 -0
  20. package/spec/admin/quotes.json +7033 -0
  21. package/spec/admin/relationships.json +13911 -0
  22. package/spec/admin/sellability.json +4840 -0
  23. package/spec/admin/storefront.json +1953 -0
  24. package/spec/admin/suppliers.json +5850 -0
  25. package/spec/admin/trips.json +9357 -0
  26. package/spec/framework-admin.json +2552 -276
  27. package/spec/framework-openapi.json +2785 -708
  28. package/spec/framework-storefront.json +252 -451
  29. package/spec/storefront/booking-requirements.json +367 -0
  30. package/spec/storefront/bookings.json +6137 -0
  31. package/spec/storefront/catalog.json +690 -0
  32. package/spec/storefront/customer-portal.json +6038 -0
  33. package/spec/storefront/finance.json +4824 -0
  34. package/spec/storefront/legal.json +2082 -0
  35. package/spec/storefront/markets.json +256 -0
  36. package/spec/storefront/operator-settings.json +309 -0
  37. package/spec/storefront/pricing.json +585 -0
  38. package/spec/storefront/products.json +2910 -0
  39. package/spec/storefront/storefront-verification.json +909 -0
  40. package/spec/storefront/storefront.json +4067 -0
  41. package/spec/storefront/trips.json +9357 -0
@@ -0,0 +1,1382 @@
1
+ {
2
+ "openapi": "3.1.0",
3
+ "info": {
4
+ "title": "Voyant Framework API",
5
+ "version": "0.0.0",
6
+ "description": "Generated from the Voyant framework's standard module composition. Do not edit by hand."
7
+ },
8
+ "components": {
9
+ "schemas": {
10
+ "CatalogSearchFilter": {
11
+ "anyOf": [
12
+ {
13
+ "type": "object",
14
+ "properties": {
15
+ "kind": {
16
+ "type": "string",
17
+ "enum": [
18
+ "eq"
19
+ ]
20
+ },
21
+ "field": {
22
+ "type": "string",
23
+ "minLength": 1
24
+ },
25
+ "value": {
26
+ "anyOf": [
27
+ {
28
+ "type": "string"
29
+ },
30
+ {
31
+ "type": "number"
32
+ },
33
+ {
34
+ "type": "boolean"
35
+ }
36
+ ]
37
+ }
38
+ },
39
+ "required": [
40
+ "kind",
41
+ "field",
42
+ "value"
43
+ ]
44
+ },
45
+ {
46
+ "type": "object",
47
+ "properties": {
48
+ "kind": {
49
+ "type": "string",
50
+ "enum": [
51
+ "in"
52
+ ]
53
+ },
54
+ "field": {
55
+ "type": "string",
56
+ "minLength": 1
57
+ },
58
+ "values": {
59
+ "type": "array",
60
+ "items": {
61
+ "anyOf": [
62
+ {
63
+ "type": "string"
64
+ },
65
+ {
66
+ "type": "number"
67
+ }
68
+ ]
69
+ }
70
+ }
71
+ },
72
+ "required": [
73
+ "kind",
74
+ "field",
75
+ "values"
76
+ ]
77
+ },
78
+ {
79
+ "type": "object",
80
+ "properties": {
81
+ "kind": {
82
+ "type": "string",
83
+ "enum": [
84
+ "range"
85
+ ]
86
+ },
87
+ "field": {
88
+ "type": "string",
89
+ "minLength": 1
90
+ },
91
+ "gte": {
92
+ "type": "number"
93
+ },
94
+ "lte": {
95
+ "type": "number"
96
+ }
97
+ },
98
+ "required": [
99
+ "kind",
100
+ "field"
101
+ ]
102
+ },
103
+ {
104
+ "type": "object",
105
+ "properties": {
106
+ "kind": {
107
+ "type": "string",
108
+ "enum": [
109
+ "and"
110
+ ]
111
+ },
112
+ "clauses": {
113
+ "type": "array",
114
+ "items": {
115
+ "$ref": "#/components/schemas/CatalogSearchFilter"
116
+ }
117
+ }
118
+ },
119
+ "required": [
120
+ "kind",
121
+ "clauses"
122
+ ]
123
+ },
124
+ {
125
+ "type": "object",
126
+ "properties": {
127
+ "kind": {
128
+ "type": "string",
129
+ "enum": [
130
+ "or"
131
+ ]
132
+ },
133
+ "clauses": {
134
+ "type": "array",
135
+ "items": {
136
+ "$ref": "#/components/schemas/CatalogSearchFilter"
137
+ }
138
+ }
139
+ },
140
+ "required": [
141
+ "kind",
142
+ "clauses"
143
+ ]
144
+ }
145
+ ]
146
+ }
147
+ },
148
+ "parameters": {}
149
+ },
150
+ "paths": {
151
+ "/v1/admin/external-refs/refs": {
152
+ "get": {
153
+ "parameters": [
154
+ {
155
+ "schema": {
156
+ "type": "integer",
157
+ "minimum": 1,
158
+ "maximum": 200,
159
+ "default": 50
160
+ },
161
+ "required": false,
162
+ "name": "limit",
163
+ "in": "query"
164
+ },
165
+ {
166
+ "schema": {
167
+ "type": [
168
+ "integer",
169
+ "null"
170
+ ],
171
+ "minimum": 0,
172
+ "default": 0
173
+ },
174
+ "required": false,
175
+ "name": "offset",
176
+ "in": "query"
177
+ },
178
+ {
179
+ "schema": {
180
+ "type": "string",
181
+ "maxLength": 100
182
+ },
183
+ "required": false,
184
+ "name": "entityType",
185
+ "in": "query"
186
+ },
187
+ {
188
+ "schema": {
189
+ "type": "string",
190
+ "maxLength": 100
191
+ },
192
+ "required": false,
193
+ "name": "entityId",
194
+ "in": "query"
195
+ },
196
+ {
197
+ "schema": {
198
+ "type": "string",
199
+ "maxLength": 100
200
+ },
201
+ "required": false,
202
+ "name": "sourceSystem",
203
+ "in": "query"
204
+ },
205
+ {
206
+ "schema": {
207
+ "type": "string",
208
+ "maxLength": 100
209
+ },
210
+ "required": false,
211
+ "name": "objectType",
212
+ "in": "query"
213
+ },
214
+ {
215
+ "schema": {
216
+ "type": "string",
217
+ "maxLength": 100
218
+ },
219
+ "required": false,
220
+ "name": "namespace",
221
+ "in": "query"
222
+ },
223
+ {
224
+ "schema": {
225
+ "type": "string",
226
+ "enum": [
227
+ "active",
228
+ "inactive",
229
+ "archived"
230
+ ]
231
+ },
232
+ "required": false,
233
+ "name": "status",
234
+ "in": "query"
235
+ },
236
+ {
237
+ "schema": {
238
+ "type": "string"
239
+ },
240
+ "required": false,
241
+ "name": "search",
242
+ "in": "query"
243
+ }
244
+ ],
245
+ "responses": {
246
+ "200": {
247
+ "description": "Paginated external references",
248
+ "content": {
249
+ "application/json": {
250
+ "schema": {
251
+ "type": "object",
252
+ "properties": {
253
+ "data": {
254
+ "type": "array",
255
+ "items": {
256
+ "type": "object",
257
+ "properties": {
258
+ "id": {
259
+ "type": "string"
260
+ },
261
+ "entityType": {
262
+ "type": "string"
263
+ },
264
+ "entityId": {
265
+ "type": "string"
266
+ },
267
+ "sourceSystem": {
268
+ "type": "string"
269
+ },
270
+ "objectType": {
271
+ "type": "string"
272
+ },
273
+ "namespace": {
274
+ "type": "string"
275
+ },
276
+ "externalId": {
277
+ "type": "string"
278
+ },
279
+ "externalParentId": {
280
+ "type": [
281
+ "string",
282
+ "null"
283
+ ]
284
+ },
285
+ "isPrimary": {
286
+ "type": "boolean"
287
+ },
288
+ "status": {
289
+ "type": "string",
290
+ "enum": [
291
+ "active",
292
+ "inactive",
293
+ "archived"
294
+ ]
295
+ },
296
+ "lastSyncedAt": {
297
+ "type": [
298
+ "string",
299
+ "null"
300
+ ]
301
+ },
302
+ "metadata": {
303
+ "type": [
304
+ "object",
305
+ "null"
306
+ ],
307
+ "additionalProperties": {}
308
+ },
309
+ "createdAt": {
310
+ "type": "string"
311
+ },
312
+ "updatedAt": {
313
+ "type": "string"
314
+ }
315
+ },
316
+ "required": [
317
+ "id",
318
+ "entityType",
319
+ "entityId",
320
+ "sourceSystem",
321
+ "objectType",
322
+ "namespace",
323
+ "externalId",
324
+ "externalParentId",
325
+ "isPrimary",
326
+ "status",
327
+ "lastSyncedAt",
328
+ "metadata",
329
+ "createdAt",
330
+ "updatedAt"
331
+ ]
332
+ }
333
+ },
334
+ "total": {
335
+ "type": "integer"
336
+ },
337
+ "limit": {
338
+ "type": "integer"
339
+ },
340
+ "offset": {
341
+ "type": "integer"
342
+ }
343
+ },
344
+ "required": [
345
+ "data",
346
+ "total",
347
+ "limit",
348
+ "offset"
349
+ ]
350
+ }
351
+ }
352
+ }
353
+ }
354
+ }
355
+ },
356
+ "post": {
357
+ "requestBody": {
358
+ "required": true,
359
+ "content": {
360
+ "application/json": {
361
+ "schema": {
362
+ "type": "object",
363
+ "properties": {
364
+ "entityType": {
365
+ "type": "string",
366
+ "minLength": 1,
367
+ "maxLength": 100
368
+ },
369
+ "entityId": {
370
+ "type": "string",
371
+ "minLength": 1,
372
+ "maxLength": 100
373
+ },
374
+ "sourceSystem": {
375
+ "type": "string",
376
+ "minLength": 1,
377
+ "maxLength": 100
378
+ },
379
+ "objectType": {
380
+ "type": "string",
381
+ "minLength": 1,
382
+ "maxLength": 100
383
+ },
384
+ "namespace": {
385
+ "type": "string",
386
+ "minLength": 1,
387
+ "maxLength": 100,
388
+ "default": "default"
389
+ },
390
+ "externalId": {
391
+ "type": "string",
392
+ "minLength": 1,
393
+ "maxLength": 255
394
+ },
395
+ "externalParentId": {
396
+ "type": [
397
+ "string",
398
+ "null"
399
+ ],
400
+ "maxLength": 255
401
+ },
402
+ "isPrimary": {
403
+ "type": "boolean",
404
+ "default": false
405
+ },
406
+ "status": {
407
+ "type": "string",
408
+ "enum": [
409
+ "active",
410
+ "inactive",
411
+ "archived"
412
+ ],
413
+ "default": "active"
414
+ },
415
+ "lastSyncedAt": {
416
+ "type": [
417
+ "string",
418
+ "null"
419
+ ]
420
+ },
421
+ "metadata": {
422
+ "type": [
423
+ "object",
424
+ "null"
425
+ ],
426
+ "additionalProperties": {}
427
+ }
428
+ },
429
+ "required": [
430
+ "entityType",
431
+ "entityId",
432
+ "sourceSystem",
433
+ "objectType",
434
+ "externalId"
435
+ ]
436
+ }
437
+ }
438
+ }
439
+ },
440
+ "responses": {
441
+ "201": {
442
+ "description": "The created external reference",
443
+ "content": {
444
+ "application/json": {
445
+ "schema": {
446
+ "type": "object",
447
+ "properties": {
448
+ "data": {
449
+ "type": "object",
450
+ "properties": {
451
+ "id": {
452
+ "type": "string"
453
+ },
454
+ "entityType": {
455
+ "type": "string"
456
+ },
457
+ "entityId": {
458
+ "type": "string"
459
+ },
460
+ "sourceSystem": {
461
+ "type": "string"
462
+ },
463
+ "objectType": {
464
+ "type": "string"
465
+ },
466
+ "namespace": {
467
+ "type": "string"
468
+ },
469
+ "externalId": {
470
+ "type": "string"
471
+ },
472
+ "externalParentId": {
473
+ "type": [
474
+ "string",
475
+ "null"
476
+ ]
477
+ },
478
+ "isPrimary": {
479
+ "type": "boolean"
480
+ },
481
+ "status": {
482
+ "type": "string",
483
+ "enum": [
484
+ "active",
485
+ "inactive",
486
+ "archived"
487
+ ]
488
+ },
489
+ "lastSyncedAt": {
490
+ "type": [
491
+ "string",
492
+ "null"
493
+ ]
494
+ },
495
+ "metadata": {
496
+ "type": [
497
+ "object",
498
+ "null"
499
+ ],
500
+ "additionalProperties": {}
501
+ },
502
+ "createdAt": {
503
+ "type": "string"
504
+ },
505
+ "updatedAt": {
506
+ "type": "string"
507
+ }
508
+ },
509
+ "required": [
510
+ "id",
511
+ "entityType",
512
+ "entityId",
513
+ "sourceSystem",
514
+ "objectType",
515
+ "namespace",
516
+ "externalId",
517
+ "externalParentId",
518
+ "isPrimary",
519
+ "status",
520
+ "lastSyncedAt",
521
+ "metadata",
522
+ "createdAt",
523
+ "updatedAt"
524
+ ]
525
+ }
526
+ },
527
+ "required": [
528
+ "data"
529
+ ]
530
+ }
531
+ }
532
+ }
533
+ },
534
+ "400": {
535
+ "description": "invalid_request",
536
+ "content": {
537
+ "application/json": {
538
+ "schema": {
539
+ "type": "object",
540
+ "properties": {
541
+ "error": {
542
+ "type": "string"
543
+ }
544
+ },
545
+ "required": [
546
+ "error"
547
+ ]
548
+ }
549
+ }
550
+ }
551
+ }
552
+ }
553
+ }
554
+ },
555
+ "/v1/admin/external-refs/refs/{id}": {
556
+ "get": {
557
+ "parameters": [
558
+ {
559
+ "schema": {
560
+ "type": "string"
561
+ },
562
+ "required": true,
563
+ "name": "id",
564
+ "in": "path"
565
+ }
566
+ ],
567
+ "responses": {
568
+ "200": {
569
+ "description": "An external reference by id",
570
+ "content": {
571
+ "application/json": {
572
+ "schema": {
573
+ "type": "object",
574
+ "properties": {
575
+ "data": {
576
+ "type": "object",
577
+ "properties": {
578
+ "id": {
579
+ "type": "string"
580
+ },
581
+ "entityType": {
582
+ "type": "string"
583
+ },
584
+ "entityId": {
585
+ "type": "string"
586
+ },
587
+ "sourceSystem": {
588
+ "type": "string"
589
+ },
590
+ "objectType": {
591
+ "type": "string"
592
+ },
593
+ "namespace": {
594
+ "type": "string"
595
+ },
596
+ "externalId": {
597
+ "type": "string"
598
+ },
599
+ "externalParentId": {
600
+ "type": [
601
+ "string",
602
+ "null"
603
+ ]
604
+ },
605
+ "isPrimary": {
606
+ "type": "boolean"
607
+ },
608
+ "status": {
609
+ "type": "string",
610
+ "enum": [
611
+ "active",
612
+ "inactive",
613
+ "archived"
614
+ ]
615
+ },
616
+ "lastSyncedAt": {
617
+ "type": [
618
+ "string",
619
+ "null"
620
+ ]
621
+ },
622
+ "metadata": {
623
+ "type": [
624
+ "object",
625
+ "null"
626
+ ],
627
+ "additionalProperties": {}
628
+ },
629
+ "createdAt": {
630
+ "type": "string"
631
+ },
632
+ "updatedAt": {
633
+ "type": "string"
634
+ }
635
+ },
636
+ "required": [
637
+ "id",
638
+ "entityType",
639
+ "entityId",
640
+ "sourceSystem",
641
+ "objectType",
642
+ "namespace",
643
+ "externalId",
644
+ "externalParentId",
645
+ "isPrimary",
646
+ "status",
647
+ "lastSyncedAt",
648
+ "metadata",
649
+ "createdAt",
650
+ "updatedAt"
651
+ ]
652
+ }
653
+ },
654
+ "required": [
655
+ "data"
656
+ ]
657
+ }
658
+ }
659
+ }
660
+ },
661
+ "404": {
662
+ "description": "External reference not found",
663
+ "content": {
664
+ "application/json": {
665
+ "schema": {
666
+ "type": "object",
667
+ "properties": {
668
+ "error": {
669
+ "type": "string"
670
+ }
671
+ },
672
+ "required": [
673
+ "error"
674
+ ]
675
+ }
676
+ }
677
+ }
678
+ }
679
+ }
680
+ },
681
+ "patch": {
682
+ "parameters": [
683
+ {
684
+ "schema": {
685
+ "type": "string"
686
+ },
687
+ "required": true,
688
+ "name": "id",
689
+ "in": "path"
690
+ }
691
+ ],
692
+ "requestBody": {
693
+ "required": true,
694
+ "content": {
695
+ "application/json": {
696
+ "schema": {
697
+ "type": "object",
698
+ "properties": {
699
+ "entityType": {
700
+ "type": "string",
701
+ "minLength": 1,
702
+ "maxLength": 100
703
+ },
704
+ "entityId": {
705
+ "type": "string",
706
+ "minLength": 1,
707
+ "maxLength": 100
708
+ },
709
+ "sourceSystem": {
710
+ "type": "string",
711
+ "minLength": 1,
712
+ "maxLength": 100
713
+ },
714
+ "objectType": {
715
+ "type": "string",
716
+ "minLength": 1,
717
+ "maxLength": 100
718
+ },
719
+ "namespace": {
720
+ "type": "string",
721
+ "minLength": 1,
722
+ "maxLength": 100,
723
+ "default": "default"
724
+ },
725
+ "externalId": {
726
+ "type": "string",
727
+ "minLength": 1,
728
+ "maxLength": 255
729
+ },
730
+ "externalParentId": {
731
+ "type": [
732
+ "string",
733
+ "null"
734
+ ],
735
+ "maxLength": 255
736
+ },
737
+ "isPrimary": {
738
+ "type": "boolean",
739
+ "default": false
740
+ },
741
+ "status": {
742
+ "type": "string",
743
+ "enum": [
744
+ "active",
745
+ "inactive",
746
+ "archived"
747
+ ],
748
+ "default": "active"
749
+ },
750
+ "lastSyncedAt": {
751
+ "type": [
752
+ "string",
753
+ "null"
754
+ ]
755
+ },
756
+ "metadata": {
757
+ "type": [
758
+ "object",
759
+ "null"
760
+ ],
761
+ "additionalProperties": {}
762
+ }
763
+ }
764
+ }
765
+ }
766
+ }
767
+ },
768
+ "responses": {
769
+ "200": {
770
+ "description": "The updated external reference",
771
+ "content": {
772
+ "application/json": {
773
+ "schema": {
774
+ "type": "object",
775
+ "properties": {
776
+ "data": {
777
+ "type": "object",
778
+ "properties": {
779
+ "id": {
780
+ "type": "string"
781
+ },
782
+ "entityType": {
783
+ "type": "string"
784
+ },
785
+ "entityId": {
786
+ "type": "string"
787
+ },
788
+ "sourceSystem": {
789
+ "type": "string"
790
+ },
791
+ "objectType": {
792
+ "type": "string"
793
+ },
794
+ "namespace": {
795
+ "type": "string"
796
+ },
797
+ "externalId": {
798
+ "type": "string"
799
+ },
800
+ "externalParentId": {
801
+ "type": [
802
+ "string",
803
+ "null"
804
+ ]
805
+ },
806
+ "isPrimary": {
807
+ "type": "boolean"
808
+ },
809
+ "status": {
810
+ "type": "string",
811
+ "enum": [
812
+ "active",
813
+ "inactive",
814
+ "archived"
815
+ ]
816
+ },
817
+ "lastSyncedAt": {
818
+ "type": [
819
+ "string",
820
+ "null"
821
+ ]
822
+ },
823
+ "metadata": {
824
+ "type": [
825
+ "object",
826
+ "null"
827
+ ],
828
+ "additionalProperties": {}
829
+ },
830
+ "createdAt": {
831
+ "type": "string"
832
+ },
833
+ "updatedAt": {
834
+ "type": "string"
835
+ }
836
+ },
837
+ "required": [
838
+ "id",
839
+ "entityType",
840
+ "entityId",
841
+ "sourceSystem",
842
+ "objectType",
843
+ "namespace",
844
+ "externalId",
845
+ "externalParentId",
846
+ "isPrimary",
847
+ "status",
848
+ "lastSyncedAt",
849
+ "metadata",
850
+ "createdAt",
851
+ "updatedAt"
852
+ ]
853
+ }
854
+ },
855
+ "required": [
856
+ "data"
857
+ ]
858
+ }
859
+ }
860
+ }
861
+ },
862
+ "400": {
863
+ "description": "invalid_request",
864
+ "content": {
865
+ "application/json": {
866
+ "schema": {
867
+ "type": "object",
868
+ "properties": {
869
+ "error": {
870
+ "type": "string"
871
+ }
872
+ },
873
+ "required": [
874
+ "error"
875
+ ]
876
+ }
877
+ }
878
+ }
879
+ },
880
+ "404": {
881
+ "description": "External reference not found",
882
+ "content": {
883
+ "application/json": {
884
+ "schema": {
885
+ "type": "object",
886
+ "properties": {
887
+ "error": {
888
+ "type": "string"
889
+ }
890
+ },
891
+ "required": [
892
+ "error"
893
+ ]
894
+ }
895
+ }
896
+ }
897
+ }
898
+ }
899
+ },
900
+ "delete": {
901
+ "parameters": [
902
+ {
903
+ "schema": {
904
+ "type": "string"
905
+ },
906
+ "required": true,
907
+ "name": "id",
908
+ "in": "path"
909
+ }
910
+ ],
911
+ "responses": {
912
+ "200": {
913
+ "description": "External reference deleted",
914
+ "content": {
915
+ "application/json": {
916
+ "schema": {
917
+ "type": "object",
918
+ "properties": {
919
+ "success": {
920
+ "type": "boolean",
921
+ "enum": [
922
+ true
923
+ ]
924
+ }
925
+ },
926
+ "required": [
927
+ "success"
928
+ ]
929
+ }
930
+ }
931
+ }
932
+ },
933
+ "404": {
934
+ "description": "External reference not found",
935
+ "content": {
936
+ "application/json": {
937
+ "schema": {
938
+ "type": "object",
939
+ "properties": {
940
+ "error": {
941
+ "type": "string"
942
+ }
943
+ },
944
+ "required": [
945
+ "error"
946
+ ]
947
+ }
948
+ }
949
+ }
950
+ }
951
+ }
952
+ }
953
+ },
954
+ "/v1/admin/external-refs/entities/{entityType}/{entityId}/refs": {
955
+ "get": {
956
+ "parameters": [
957
+ {
958
+ "schema": {
959
+ "type": "string"
960
+ },
961
+ "required": true,
962
+ "name": "entityType",
963
+ "in": "path"
964
+ },
965
+ {
966
+ "schema": {
967
+ "type": "string"
968
+ },
969
+ "required": true,
970
+ "name": "entityId",
971
+ "in": "path"
972
+ },
973
+ {
974
+ "schema": {
975
+ "type": "integer",
976
+ "minimum": 1,
977
+ "maximum": 200,
978
+ "default": 50
979
+ },
980
+ "required": false,
981
+ "name": "limit",
982
+ "in": "query"
983
+ },
984
+ {
985
+ "schema": {
986
+ "type": [
987
+ "integer",
988
+ "null"
989
+ ],
990
+ "minimum": 0,
991
+ "default": 0
992
+ },
993
+ "required": false,
994
+ "name": "offset",
995
+ "in": "query"
996
+ },
997
+ {
998
+ "schema": {
999
+ "type": "string",
1000
+ "maxLength": 100
1001
+ },
1002
+ "required": false,
1003
+ "name": "entityType",
1004
+ "in": "query"
1005
+ },
1006
+ {
1007
+ "schema": {
1008
+ "type": "string",
1009
+ "maxLength": 100
1010
+ },
1011
+ "required": false,
1012
+ "name": "entityId",
1013
+ "in": "query"
1014
+ },
1015
+ {
1016
+ "schema": {
1017
+ "type": "string",
1018
+ "maxLength": 100
1019
+ },
1020
+ "required": false,
1021
+ "name": "sourceSystem",
1022
+ "in": "query"
1023
+ },
1024
+ {
1025
+ "schema": {
1026
+ "type": "string",
1027
+ "maxLength": 100
1028
+ },
1029
+ "required": false,
1030
+ "name": "objectType",
1031
+ "in": "query"
1032
+ },
1033
+ {
1034
+ "schema": {
1035
+ "type": "string",
1036
+ "maxLength": 100
1037
+ },
1038
+ "required": false,
1039
+ "name": "namespace",
1040
+ "in": "query"
1041
+ },
1042
+ {
1043
+ "schema": {
1044
+ "type": "string",
1045
+ "enum": [
1046
+ "active",
1047
+ "inactive",
1048
+ "archived"
1049
+ ]
1050
+ },
1051
+ "required": false,
1052
+ "name": "status",
1053
+ "in": "query"
1054
+ },
1055
+ {
1056
+ "schema": {
1057
+ "type": "string"
1058
+ },
1059
+ "required": false,
1060
+ "name": "search",
1061
+ "in": "query"
1062
+ }
1063
+ ],
1064
+ "responses": {
1065
+ "200": {
1066
+ "description": "Paginated external references for an entity",
1067
+ "content": {
1068
+ "application/json": {
1069
+ "schema": {
1070
+ "type": "object",
1071
+ "properties": {
1072
+ "data": {
1073
+ "type": "array",
1074
+ "items": {
1075
+ "type": "object",
1076
+ "properties": {
1077
+ "id": {
1078
+ "type": "string"
1079
+ },
1080
+ "entityType": {
1081
+ "type": "string"
1082
+ },
1083
+ "entityId": {
1084
+ "type": "string"
1085
+ },
1086
+ "sourceSystem": {
1087
+ "type": "string"
1088
+ },
1089
+ "objectType": {
1090
+ "type": "string"
1091
+ },
1092
+ "namespace": {
1093
+ "type": "string"
1094
+ },
1095
+ "externalId": {
1096
+ "type": "string"
1097
+ },
1098
+ "externalParentId": {
1099
+ "type": [
1100
+ "string",
1101
+ "null"
1102
+ ]
1103
+ },
1104
+ "isPrimary": {
1105
+ "type": "boolean"
1106
+ },
1107
+ "status": {
1108
+ "type": "string",
1109
+ "enum": [
1110
+ "active",
1111
+ "inactive",
1112
+ "archived"
1113
+ ]
1114
+ },
1115
+ "lastSyncedAt": {
1116
+ "type": [
1117
+ "string",
1118
+ "null"
1119
+ ]
1120
+ },
1121
+ "metadata": {
1122
+ "type": [
1123
+ "object",
1124
+ "null"
1125
+ ],
1126
+ "additionalProperties": {}
1127
+ },
1128
+ "createdAt": {
1129
+ "type": "string"
1130
+ },
1131
+ "updatedAt": {
1132
+ "type": "string"
1133
+ }
1134
+ },
1135
+ "required": [
1136
+ "id",
1137
+ "entityType",
1138
+ "entityId",
1139
+ "sourceSystem",
1140
+ "objectType",
1141
+ "namespace",
1142
+ "externalId",
1143
+ "externalParentId",
1144
+ "isPrimary",
1145
+ "status",
1146
+ "lastSyncedAt",
1147
+ "metadata",
1148
+ "createdAt",
1149
+ "updatedAt"
1150
+ ]
1151
+ }
1152
+ },
1153
+ "total": {
1154
+ "type": "integer"
1155
+ },
1156
+ "limit": {
1157
+ "type": "integer"
1158
+ },
1159
+ "offset": {
1160
+ "type": "integer"
1161
+ }
1162
+ },
1163
+ "required": [
1164
+ "data",
1165
+ "total",
1166
+ "limit",
1167
+ "offset"
1168
+ ]
1169
+ }
1170
+ }
1171
+ }
1172
+ }
1173
+ }
1174
+ },
1175
+ "post": {
1176
+ "parameters": [
1177
+ {
1178
+ "schema": {
1179
+ "type": "string"
1180
+ },
1181
+ "required": true,
1182
+ "name": "entityType",
1183
+ "in": "path"
1184
+ },
1185
+ {
1186
+ "schema": {
1187
+ "type": "string"
1188
+ },
1189
+ "required": true,
1190
+ "name": "entityId",
1191
+ "in": "path"
1192
+ }
1193
+ ],
1194
+ "requestBody": {
1195
+ "required": true,
1196
+ "content": {
1197
+ "application/json": {
1198
+ "schema": {
1199
+ "type": "object",
1200
+ "properties": {
1201
+ "sourceSystem": {
1202
+ "type": "string",
1203
+ "minLength": 1,
1204
+ "maxLength": 100
1205
+ },
1206
+ "objectType": {
1207
+ "type": "string",
1208
+ "minLength": 1,
1209
+ "maxLength": 100
1210
+ },
1211
+ "namespace": {
1212
+ "type": "string",
1213
+ "minLength": 1,
1214
+ "maxLength": 100,
1215
+ "default": "default"
1216
+ },
1217
+ "externalId": {
1218
+ "type": "string",
1219
+ "minLength": 1,
1220
+ "maxLength": 255
1221
+ },
1222
+ "externalParentId": {
1223
+ "type": [
1224
+ "string",
1225
+ "null"
1226
+ ],
1227
+ "maxLength": 255
1228
+ },
1229
+ "isPrimary": {
1230
+ "type": "boolean",
1231
+ "default": false
1232
+ },
1233
+ "status": {
1234
+ "type": "string",
1235
+ "enum": [
1236
+ "active",
1237
+ "inactive",
1238
+ "archived"
1239
+ ],
1240
+ "default": "active"
1241
+ },
1242
+ "lastSyncedAt": {
1243
+ "type": [
1244
+ "string",
1245
+ "null"
1246
+ ]
1247
+ },
1248
+ "metadata": {
1249
+ "type": [
1250
+ "object",
1251
+ "null"
1252
+ ],
1253
+ "additionalProperties": {}
1254
+ }
1255
+ },
1256
+ "required": [
1257
+ "sourceSystem",
1258
+ "objectType",
1259
+ "externalId"
1260
+ ]
1261
+ }
1262
+ }
1263
+ }
1264
+ },
1265
+ "responses": {
1266
+ "201": {
1267
+ "description": "The created external reference for an entity",
1268
+ "content": {
1269
+ "application/json": {
1270
+ "schema": {
1271
+ "type": "object",
1272
+ "properties": {
1273
+ "data": {
1274
+ "type": "object",
1275
+ "properties": {
1276
+ "id": {
1277
+ "type": "string"
1278
+ },
1279
+ "entityType": {
1280
+ "type": "string"
1281
+ },
1282
+ "entityId": {
1283
+ "type": "string"
1284
+ },
1285
+ "sourceSystem": {
1286
+ "type": "string"
1287
+ },
1288
+ "objectType": {
1289
+ "type": "string"
1290
+ },
1291
+ "namespace": {
1292
+ "type": "string"
1293
+ },
1294
+ "externalId": {
1295
+ "type": "string"
1296
+ },
1297
+ "externalParentId": {
1298
+ "type": [
1299
+ "string",
1300
+ "null"
1301
+ ]
1302
+ },
1303
+ "isPrimary": {
1304
+ "type": "boolean"
1305
+ },
1306
+ "status": {
1307
+ "type": "string",
1308
+ "enum": [
1309
+ "active",
1310
+ "inactive",
1311
+ "archived"
1312
+ ]
1313
+ },
1314
+ "lastSyncedAt": {
1315
+ "type": [
1316
+ "string",
1317
+ "null"
1318
+ ]
1319
+ },
1320
+ "metadata": {
1321
+ "type": [
1322
+ "object",
1323
+ "null"
1324
+ ],
1325
+ "additionalProperties": {}
1326
+ },
1327
+ "createdAt": {
1328
+ "type": "string"
1329
+ },
1330
+ "updatedAt": {
1331
+ "type": "string"
1332
+ }
1333
+ },
1334
+ "required": [
1335
+ "id",
1336
+ "entityType",
1337
+ "entityId",
1338
+ "sourceSystem",
1339
+ "objectType",
1340
+ "namespace",
1341
+ "externalId",
1342
+ "externalParentId",
1343
+ "isPrimary",
1344
+ "status",
1345
+ "lastSyncedAt",
1346
+ "metadata",
1347
+ "createdAt",
1348
+ "updatedAt"
1349
+ ]
1350
+ }
1351
+ },
1352
+ "required": [
1353
+ "data"
1354
+ ]
1355
+ }
1356
+ }
1357
+ }
1358
+ },
1359
+ "400": {
1360
+ "description": "invalid_request",
1361
+ "content": {
1362
+ "application/json": {
1363
+ "schema": {
1364
+ "type": "object",
1365
+ "properties": {
1366
+ "error": {
1367
+ "type": "string"
1368
+ }
1369
+ },
1370
+ "required": [
1371
+ "error"
1372
+ ]
1373
+ }
1374
+ }
1375
+ }
1376
+ }
1377
+ }
1378
+ }
1379
+ }
1380
+ },
1381
+ "webhooks": {}
1382
+ }