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