@anyproto/anytype-mcp 1.0.2 → 1.0.3

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.
@@ -0,0 +1,2555 @@
1
+ {
2
+ "openapi": "3.1.0",
3
+ "info": {
4
+ "title": "eBay Trading API",
5
+ "version": "1.0.0",
6
+ "description": "API for interacting with eBay Trading API"
7
+ },
8
+ "servers": [
9
+ {
10
+ "url": "https://ba4d8125-91e3-402e-8041-1ac825d3a3da-00-1p96pqe01w7ko.kirk.replit.dev"
11
+ }
12
+ ],
13
+ "components": {
14
+ "securitySchemes": {
15
+ "bearerAuth": {
16
+ "type": "http",
17
+ "scheme": "bearer"
18
+ }
19
+ },
20
+ "schemas": {}
21
+ },
22
+ "paths": {
23
+ "/api/ebay/categories/top-level": {
24
+ "get": {
25
+ "tags": [
26
+ "Categories"
27
+ ],
28
+ "summary": "Get top-level eBay categories",
29
+ "description": "Returns a list of all top-level categories for the specified eBay site",
30
+ "security": [
31
+ {
32
+ "bearer": [
33
+ "https://api.ebay.com/oauth/api_scope"
34
+ ]
35
+ }
36
+ ],
37
+ "parameters": [
38
+ {
39
+ "name": "userId",
40
+ "in": "query",
41
+ "required": true,
42
+ "schema": {
43
+ "type": "string",
44
+ "description": "eBay user ID"
45
+ },
46
+ "description": "eBay user ID"
47
+ },
48
+ {
49
+ "name": "siteId",
50
+ "in": "query",
51
+ "required": true,
52
+ "schema": {
53
+ "type": "string",
54
+ "description": "eBay site ID (e.g., 'EBAY_US')"
55
+ },
56
+ "description": "eBay site ID (e.g., 'EBAY_US')"
57
+ }
58
+ ],
59
+ "responses": {
60
+ "200": {
61
+ "description": "Successful response",
62
+ "content": {
63
+ "application/json": {
64
+ "schema": {
65
+ "type": "object",
66
+ "properties": {
67
+ "status": {
68
+ "type": "string",
69
+ "enum": [
70
+ "success"
71
+ ]
72
+ },
73
+ "data": {
74
+ "type": "array",
75
+ "items": {
76
+ "type": "object",
77
+ "properties": {
78
+ "id": {
79
+ "oneOf": [
80
+ {
81
+ "type": "string"
82
+ },
83
+ {
84
+ "type": "number"
85
+ }
86
+ ],
87
+ "description": "Category ID"
88
+ },
89
+ "name": {
90
+ "type": "string",
91
+ "description": "Category name"
92
+ },
93
+ "level": {
94
+ "type": "number",
95
+ "description": "Category level in hierarchy"
96
+ },
97
+ "parentId": {
98
+ "oneOf": [
99
+ {
100
+ "type": "string"
101
+ },
102
+ {
103
+ "type": "number"
104
+ }
105
+ ],
106
+ "description": "Parent category ID"
107
+ },
108
+ "isLeaf": {
109
+ "type": "boolean",
110
+ "description": "Whether this is a leaf category"
111
+ },
112
+ "fullPath": {
113
+ "type": "string",
114
+ "description": "Full category path"
115
+ },
116
+ "parentIds": {
117
+ "type": "array",
118
+ "items": {
119
+ "oneOf": [
120
+ {
121
+ "type": "string"
122
+ },
123
+ {
124
+ "type": "number"
125
+ }
126
+ ]
127
+ },
128
+ "description": "Array of parent category IDs"
129
+ }
130
+ },
131
+ "required": [
132
+ "id",
133
+ "name",
134
+ "level",
135
+ "parentId",
136
+ "isLeaf"
137
+ ]
138
+ }
139
+ }
140
+ },
141
+ "required": [
142
+ "status",
143
+ "data"
144
+ ]
145
+ }
146
+ }
147
+ }
148
+ },
149
+ "400": {
150
+ "description": "Invalid request parameters",
151
+ "content": {
152
+ "application/json": {
153
+ "schema": {
154
+ "type": "object",
155
+ "properties": {
156
+ "error": {
157
+ "type": "string"
158
+ },
159
+ "code": {
160
+ "type": "string"
161
+ },
162
+ "details": {
163
+ "type": "array",
164
+ "items": {}
165
+ }
166
+ },
167
+ "required": [
168
+ "error",
169
+ "code"
170
+ ]
171
+ }
172
+ }
173
+ }
174
+ },
175
+ "401": {
176
+ "description": "Unauthorized - Invalid or missing eBay token",
177
+ "content": {
178
+ "application/json": {
179
+ "schema": {
180
+ "type": "object",
181
+ "properties": {
182
+ "error": {
183
+ "type": "string"
184
+ },
185
+ "code": {
186
+ "type": "string"
187
+ },
188
+ "details": {
189
+ "type": "array",
190
+ "items": {}
191
+ }
192
+ },
193
+ "required": [
194
+ "error",
195
+ "code"
196
+ ]
197
+ }
198
+ }
199
+ }
200
+ },
201
+ "403": {
202
+ "description": "Forbidden",
203
+ "content": {
204
+ "application/json": {
205
+ "schema": {
206
+ "type": "object",
207
+ "properties": {
208
+ "error": {
209
+ "type": "string"
210
+ },
211
+ "code": {
212
+ "type": "string"
213
+ },
214
+ "details": {
215
+ "type": "array",
216
+ "items": {}
217
+ }
218
+ },
219
+ "required": [
220
+ "error",
221
+ "code"
222
+ ]
223
+ }
224
+ }
225
+ }
226
+ },
227
+ "500": {
228
+ "description": "Internal server error",
229
+ "content": {
230
+ "application/json": {
231
+ "schema": {
232
+ "type": "object",
233
+ "properties": {
234
+ "error": {
235
+ "type": "string"
236
+ },
237
+ "code": {
238
+ "type": "string"
239
+ },
240
+ "details": {
241
+ "type": "array",
242
+ "items": {}
243
+ }
244
+ },
245
+ "required": [
246
+ "error",
247
+ "code"
248
+ ]
249
+ }
250
+ }
251
+ }
252
+ }
253
+ },
254
+ "operationId": "get_api_ebay_categories_top_level_833ef4a3"
255
+ }
256
+ },
257
+ "/api/ebay/categories/leaves/{categoryId}": {
258
+ "get": {
259
+ "tags": [
260
+ "Categories"
261
+ ],
262
+ "summary": "Get leaf categories",
263
+ "description": "Returns all leaf categories under the specified parent category",
264
+ "security": [
265
+ {
266
+ "bearer": [
267
+ "https://api.ebay.com/oauth/api_scope"
268
+ ]
269
+ }
270
+ ],
271
+ "parameters": [
272
+ {
273
+ "name": "categoryId",
274
+ "in": "path",
275
+ "required": true,
276
+ "schema": {
277
+ "type": "string",
278
+ "description": "Parent category ID"
279
+ },
280
+ "description": "Parent category ID"
281
+ },
282
+ {
283
+ "name": "userId",
284
+ "in": "query",
285
+ "required": true,
286
+ "schema": {
287
+ "type": "string",
288
+ "description": "eBay user ID"
289
+ },
290
+ "description": "eBay user ID"
291
+ },
292
+ {
293
+ "name": "siteId",
294
+ "in": "query",
295
+ "required": true,
296
+ "schema": {
297
+ "type": "string",
298
+ "description": "eBay site ID (e.g., 'EBAY_US')"
299
+ },
300
+ "description": "eBay site ID (e.g., 'EBAY_US')"
301
+ }
302
+ ],
303
+ "responses": {
304
+ "200": {
305
+ "description": "Successful response",
306
+ "content": {
307
+ "application/json": {
308
+ "schema": {
309
+ "type": "object",
310
+ "properties": {
311
+ "status": {
312
+ "type": "string",
313
+ "enum": [
314
+ "success"
315
+ ]
316
+ },
317
+ "data": {
318
+ "type": "array",
319
+ "items": {
320
+ "type": "object",
321
+ "properties": {
322
+ "id": {
323
+ "oneOf": [
324
+ {
325
+ "type": "string"
326
+ },
327
+ {
328
+ "type": "number"
329
+ }
330
+ ],
331
+ "description": "Category ID"
332
+ },
333
+ "name": {
334
+ "type": "string",
335
+ "description": "Category name"
336
+ },
337
+ "level": {
338
+ "type": "number",
339
+ "description": "Category level in hierarchy"
340
+ },
341
+ "parentId": {
342
+ "oneOf": [
343
+ {
344
+ "type": "string"
345
+ },
346
+ {
347
+ "type": "number"
348
+ }
349
+ ],
350
+ "description": "Parent category ID"
351
+ },
352
+ "isLeaf": {
353
+ "type": "boolean",
354
+ "description": "Whether this is a leaf category"
355
+ },
356
+ "fullPath": {
357
+ "type": "string",
358
+ "description": "Full category path"
359
+ },
360
+ "parentIds": {
361
+ "type": "array",
362
+ "items": {
363
+ "oneOf": [
364
+ {
365
+ "type": "string"
366
+ },
367
+ {
368
+ "type": "number"
369
+ }
370
+ ]
371
+ },
372
+ "description": "Array of parent category IDs"
373
+ }
374
+ },
375
+ "required": [
376
+ "id",
377
+ "name",
378
+ "level",
379
+ "parentId",
380
+ "isLeaf"
381
+ ]
382
+ }
383
+ }
384
+ },
385
+ "required": [
386
+ "status",
387
+ "data"
388
+ ]
389
+ }
390
+ }
391
+ }
392
+ },
393
+ "400": {
394
+ "description": "Invalid request parameters",
395
+ "content": {
396
+ "application/json": {
397
+ "schema": {
398
+ "type": "object",
399
+ "properties": {
400
+ "error": {
401
+ "type": "string"
402
+ },
403
+ "code": {
404
+ "type": "string"
405
+ },
406
+ "details": {
407
+ "type": "array",
408
+ "items": {}
409
+ }
410
+ },
411
+ "required": [
412
+ "error",
413
+ "code"
414
+ ]
415
+ }
416
+ }
417
+ }
418
+ },
419
+ "401": {
420
+ "description": "Unauthorized - Invalid or missing eBay token",
421
+ "content": {
422
+ "application/json": {
423
+ "schema": {
424
+ "type": "object",
425
+ "properties": {
426
+ "error": {
427
+ "type": "string"
428
+ },
429
+ "code": {
430
+ "type": "string"
431
+ },
432
+ "details": {
433
+ "type": "array",
434
+ "items": {}
435
+ }
436
+ },
437
+ "required": [
438
+ "error",
439
+ "code"
440
+ ]
441
+ }
442
+ }
443
+ }
444
+ },
445
+ "403": {
446
+ "description": "Forbidden",
447
+ "content": {
448
+ "application/json": {
449
+ "schema": {
450
+ "type": "object",
451
+ "properties": {
452
+ "error": {
453
+ "type": "string"
454
+ },
455
+ "code": {
456
+ "type": "string"
457
+ },
458
+ "details": {
459
+ "type": "array",
460
+ "items": {}
461
+ }
462
+ },
463
+ "required": [
464
+ "error",
465
+ "code"
466
+ ]
467
+ }
468
+ }
469
+ }
470
+ },
471
+ "500": {
472
+ "description": "Internal server error",
473
+ "content": {
474
+ "application/json": {
475
+ "schema": {
476
+ "type": "object",
477
+ "properties": {
478
+ "error": {
479
+ "type": "string"
480
+ },
481
+ "code": {
482
+ "type": "string"
483
+ },
484
+ "details": {
485
+ "type": "array",
486
+ "items": {}
487
+ }
488
+ },
489
+ "required": [
490
+ "error",
491
+ "code"
492
+ ]
493
+ }
494
+ }
495
+ }
496
+ }
497
+ },
498
+ "operationId": "get_api_ebay_categories_leaves_3ea8b601"
499
+ }
500
+ },
501
+ "/api/ebay/categories/conditions/{categoryId}": {
502
+ "get": {
503
+ "tags": [
504
+ "Categories"
505
+ ],
506
+ "summary": "Get category condition policies",
507
+ "description": "Returns the condition policies for a specific category",
508
+ "security": [
509
+ {
510
+ "bearer": [
511
+ "https://api.ebay.com/oauth/api_scope"
512
+ ]
513
+ }
514
+ ],
515
+ "parameters": [
516
+ {
517
+ "name": "categoryId",
518
+ "in": "path",
519
+ "required": true,
520
+ "schema": {
521
+ "type": "string",
522
+ "description": "Category ID"
523
+ },
524
+ "description": "Category ID"
525
+ },
526
+ {
527
+ "name": "userId",
528
+ "in": "query",
529
+ "required": true,
530
+ "schema": {
531
+ "type": "string",
532
+ "description": "eBay user ID"
533
+ },
534
+ "description": "eBay user ID"
535
+ },
536
+ {
537
+ "name": "marketplaceId",
538
+ "in": "query",
539
+ "required": true,
540
+ "schema": {
541
+ "type": "string",
542
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
543
+ },
544
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
545
+ }
546
+ ],
547
+ "responses": {
548
+ "200": {
549
+ "description": "Successful response",
550
+ "content": {
551
+ "application/json": {
552
+ "schema": {
553
+ "type": "object",
554
+ "properties": {
555
+ "status": {
556
+ "type": "string",
557
+ "enum": [
558
+ "success"
559
+ ]
560
+ },
561
+ "data": {
562
+ "type": "object",
563
+ "properties": {
564
+ "categoryId": {
565
+ "oneOf": [
566
+ {
567
+ "type": "string"
568
+ },
569
+ {
570
+ "type": "number"
571
+ }
572
+ ],
573
+ "description": "The category ID"
574
+ },
575
+ "conditionDescriptors": {
576
+ "type": "array",
577
+ "items": {
578
+ "type": "object",
579
+ "properties": {
580
+ "id": {
581
+ "type": "string",
582
+ "description": "The condition ID"
583
+ },
584
+ "description": {
585
+ "type": "string",
586
+ "description": "Description of the condition"
587
+ }
588
+ },
589
+ "required": [
590
+ "id"
591
+ ]
592
+ }
593
+ }
594
+ },
595
+ "required": [
596
+ "categoryId",
597
+ "conditionDescriptors"
598
+ ]
599
+ }
600
+ },
601
+ "required": [
602
+ "status",
603
+ "data"
604
+ ]
605
+ }
606
+ }
607
+ }
608
+ },
609
+ "400": {
610
+ "description": "Invalid request parameters",
611
+ "content": {
612
+ "application/json": {
613
+ "schema": {
614
+ "type": "object",
615
+ "properties": {
616
+ "error": {
617
+ "type": "string"
618
+ },
619
+ "code": {
620
+ "type": "string"
621
+ },
622
+ "details": {
623
+ "type": "array",
624
+ "items": {}
625
+ }
626
+ },
627
+ "required": [
628
+ "error",
629
+ "code"
630
+ ]
631
+ }
632
+ }
633
+ }
634
+ },
635
+ "401": {
636
+ "description": "Unauthorized - Invalid or missing eBay token",
637
+ "content": {
638
+ "application/json": {
639
+ "schema": {
640
+ "type": "object",
641
+ "properties": {
642
+ "error": {
643
+ "type": "string"
644
+ },
645
+ "code": {
646
+ "type": "string"
647
+ },
648
+ "details": {
649
+ "type": "array",
650
+ "items": {}
651
+ }
652
+ },
653
+ "required": [
654
+ "error",
655
+ "code"
656
+ ]
657
+ }
658
+ }
659
+ }
660
+ },
661
+ "403": {
662
+ "description": "Forbidden",
663
+ "content": {
664
+ "application/json": {
665
+ "schema": {
666
+ "type": "object",
667
+ "properties": {
668
+ "error": {
669
+ "type": "string"
670
+ },
671
+ "code": {
672
+ "type": "string"
673
+ },
674
+ "details": {
675
+ "type": "array",
676
+ "items": {}
677
+ }
678
+ },
679
+ "required": [
680
+ "error",
681
+ "code"
682
+ ]
683
+ }
684
+ }
685
+ }
686
+ },
687
+ "404": {
688
+ "description": "No condition policies found for the category",
689
+ "content": {
690
+ "application/json": {
691
+ "schema": {
692
+ "type": "object",
693
+ "properties": {
694
+ "error": {
695
+ "type": "string"
696
+ },
697
+ "code": {
698
+ "type": "string"
699
+ },
700
+ "details": {
701
+ "type": "array",
702
+ "items": {}
703
+ }
704
+ },
705
+ "required": [
706
+ "error",
707
+ "code"
708
+ ]
709
+ }
710
+ }
711
+ }
712
+ },
713
+ "500": {
714
+ "description": "Internal server error",
715
+ "content": {
716
+ "application/json": {
717
+ "schema": {
718
+ "type": "object",
719
+ "properties": {
720
+ "error": {
721
+ "type": "string"
722
+ },
723
+ "code": {
724
+ "type": "string"
725
+ },
726
+ "details": {
727
+ "type": "array",
728
+ "items": {}
729
+ }
730
+ },
731
+ "required": [
732
+ "error",
733
+ "code"
734
+ ]
735
+ }
736
+ }
737
+ }
738
+ }
739
+ },
740
+ "operationId": "get_api_ebay_categories_conditions_0196f1da"
741
+ }
742
+ },
743
+ "/api/ebay/categories/{categoryId}/aspects": {
744
+ "get": {
745
+ "tags": [
746
+ "Categories"
747
+ ],
748
+ "summary": "Get category aspects",
749
+ "description": "Returns the required and optional item aspects for a specific category",
750
+ "security": [
751
+ {
752
+ "bearer": [
753
+ "https://api.ebay.com/oauth/api_scope"
754
+ ]
755
+ }
756
+ ],
757
+ "parameters": [
758
+ {
759
+ "name": "categoryId",
760
+ "in": "path",
761
+ "required": true,
762
+ "schema": {
763
+ "type": "string",
764
+ "description": "Category ID"
765
+ },
766
+ "description": "Category ID"
767
+ },
768
+ {
769
+ "name": "userId",
770
+ "in": "query",
771
+ "required": true,
772
+ "schema": {
773
+ "type": "string",
774
+ "description": "eBay user ID"
775
+ },
776
+ "description": "eBay user ID"
777
+ },
778
+ {
779
+ "name": "marketplaceId",
780
+ "in": "query",
781
+ "required": true,
782
+ "schema": {
783
+ "type": "string",
784
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
785
+ },
786
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
787
+ }
788
+ ],
789
+ "responses": {
790
+ "200": {
791
+ "description": "Successful response",
792
+ "content": {
793
+ "application/json": {
794
+ "schema": {
795
+ "type": "object",
796
+ "properties": {
797
+ "status": {
798
+ "type": "string",
799
+ "enum": [
800
+ "success"
801
+ ]
802
+ },
803
+ "data": {
804
+ "type": "object",
805
+ "properties": {
806
+ "aspects": {
807
+ "type": "array",
808
+ "items": {
809
+ "type": "object",
810
+ "properties": {
811
+ "localizedAspectName": {
812
+ "type": "string"
813
+ },
814
+ "aspectConstraint": {
815
+ "type": "object",
816
+ "properties": {
817
+ "aspectDataType": {
818
+ "type": "string",
819
+ "enum": [
820
+ "DATE",
821
+ "NUMBER",
822
+ "STRING",
823
+ "TEXT"
824
+ ]
825
+ },
826
+ "aspectEnabledForVariations": {
827
+ "type": "boolean"
828
+ },
829
+ "aspectFormat": {
830
+ "type": "string"
831
+ },
832
+ "aspectMaxLength": {
833
+ "type": "number"
834
+ },
835
+ "aspectMode": {
836
+ "type": "string",
837
+ "enum": [
838
+ "FREE_TEXT",
839
+ "SELECTION_ONLY"
840
+ ]
841
+ },
842
+ "aspectRequired": {
843
+ "type": "boolean"
844
+ },
845
+ "aspectUsage": {
846
+ "type": "string",
847
+ "enum": [
848
+ "RECOMMENDED",
849
+ "OPTIONAL"
850
+ ]
851
+ },
852
+ "expectedRequiredByDate": {
853
+ "type": "string"
854
+ },
855
+ "itemToAspectCardinality": {
856
+ "type": "string",
857
+ "enum": [
858
+ "MULTI",
859
+ "SINGLE"
860
+ ]
861
+ }
862
+ },
863
+ "required": [
864
+ "aspectDataType",
865
+ "aspectEnabledForVariations",
866
+ "aspectMode",
867
+ "aspectRequired",
868
+ "aspectUsage",
869
+ "itemToAspectCardinality"
870
+ ]
871
+ },
872
+ "aspectValues": {
873
+ "type": "array",
874
+ "items": {
875
+ "type": "string"
876
+ }
877
+ },
878
+ "relevanceIndicator": {
879
+ "type": "object",
880
+ "properties": {
881
+ "searchCount": {
882
+ "type": "number"
883
+ }
884
+ },
885
+ "required": [
886
+ "searchCount"
887
+ ]
888
+ }
889
+ },
890
+ "required": [
891
+ "localizedAspectName",
892
+ "aspectConstraint"
893
+ ]
894
+ }
895
+ }
896
+ },
897
+ "required": [
898
+ "aspects"
899
+ ]
900
+ }
901
+ },
902
+ "required": [
903
+ "status",
904
+ "data"
905
+ ]
906
+ }
907
+ }
908
+ }
909
+ },
910
+ "400": {
911
+ "description": "Invalid request parameters",
912
+ "content": {
913
+ "application/json": {
914
+ "schema": {
915
+ "type": "object",
916
+ "properties": {
917
+ "error": {
918
+ "type": "string"
919
+ },
920
+ "code": {
921
+ "type": "string"
922
+ },
923
+ "details": {
924
+ "type": "array",
925
+ "items": {}
926
+ }
927
+ },
928
+ "required": [
929
+ "error",
930
+ "code"
931
+ ]
932
+ }
933
+ }
934
+ }
935
+ },
936
+ "401": {
937
+ "description": "Unauthorized - Invalid or missing eBay token",
938
+ "content": {
939
+ "application/json": {
940
+ "schema": {
941
+ "type": "object",
942
+ "properties": {
943
+ "error": {
944
+ "type": "string"
945
+ },
946
+ "code": {
947
+ "type": "string"
948
+ },
949
+ "details": {
950
+ "type": "array",
951
+ "items": {}
952
+ }
953
+ },
954
+ "required": [
955
+ "error",
956
+ "code"
957
+ ]
958
+ }
959
+ }
960
+ }
961
+ },
962
+ "403": {
963
+ "description": "Forbidden",
964
+ "content": {
965
+ "application/json": {
966
+ "schema": {
967
+ "type": "object",
968
+ "properties": {
969
+ "error": {
970
+ "type": "string"
971
+ },
972
+ "code": {
973
+ "type": "string"
974
+ },
975
+ "details": {
976
+ "type": "array",
977
+ "items": {}
978
+ }
979
+ },
980
+ "required": [
981
+ "error",
982
+ "code"
983
+ ]
984
+ }
985
+ }
986
+ }
987
+ },
988
+ "404": {
989
+ "description": "No aspects found for the category",
990
+ "content": {
991
+ "application/json": {
992
+ "schema": {
993
+ "type": "object",
994
+ "properties": {
995
+ "error": {
996
+ "type": "string"
997
+ },
998
+ "code": {
999
+ "type": "string"
1000
+ },
1001
+ "details": {
1002
+ "type": "array",
1003
+ "items": {}
1004
+ }
1005
+ },
1006
+ "required": [
1007
+ "error",
1008
+ "code"
1009
+ ]
1010
+ }
1011
+ }
1012
+ }
1013
+ },
1014
+ "500": {
1015
+ "description": "Internal server error",
1016
+ "content": {
1017
+ "application/json": {
1018
+ "schema": {
1019
+ "type": "object",
1020
+ "properties": {
1021
+ "error": {
1022
+ "type": "string"
1023
+ },
1024
+ "code": {
1025
+ "type": "string"
1026
+ },
1027
+ "details": {
1028
+ "type": "array",
1029
+ "items": {}
1030
+ }
1031
+ },
1032
+ "required": [
1033
+ "error",
1034
+ "code"
1035
+ ]
1036
+ }
1037
+ }
1038
+ }
1039
+ }
1040
+ },
1041
+ "operationId": "get_api_ebay_categories_aspects_59d62e7d"
1042
+ }
1043
+ },
1044
+ "/api/ebay/categories/{categoryId}/listing-requirements": {
1045
+ "get": {
1046
+ "tags": [
1047
+ "Categories"
1048
+ ],
1049
+ "summary": "Get category listing requirements",
1050
+ "description": "Returns both the required/optional item aspects and allowed conditions for a specific category",
1051
+ "security": [
1052
+ {
1053
+ "bearer": [
1054
+ "https://api.ebay.com/oauth/api_scope"
1055
+ ]
1056
+ }
1057
+ ],
1058
+ "parameters": [
1059
+ {
1060
+ "name": "categoryId",
1061
+ "in": "path",
1062
+ "required": true,
1063
+ "schema": {
1064
+ "type": "string",
1065
+ "description": "Category ID"
1066
+ },
1067
+ "description": "Category ID"
1068
+ },
1069
+ {
1070
+ "name": "userId",
1071
+ "in": "query",
1072
+ "required": true,
1073
+ "schema": {
1074
+ "type": "string",
1075
+ "description": "eBay user ID"
1076
+ },
1077
+ "description": "eBay user ID"
1078
+ },
1079
+ {
1080
+ "name": "marketplaceId",
1081
+ "in": "query",
1082
+ "required": true,
1083
+ "schema": {
1084
+ "type": "string",
1085
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
1086
+ },
1087
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
1088
+ }
1089
+ ],
1090
+ "responses": {
1091
+ "200": {
1092
+ "description": "Successful response",
1093
+ "content": {
1094
+ "application/json": {
1095
+ "schema": {
1096
+ "type": "object",
1097
+ "properties": {
1098
+ "status": {
1099
+ "type": "string",
1100
+ "enum": [
1101
+ "success"
1102
+ ]
1103
+ },
1104
+ "data": {
1105
+ "type": "object",
1106
+ "properties": {
1107
+ "categoryId": {
1108
+ "oneOf": [
1109
+ {
1110
+ "type": "string"
1111
+ },
1112
+ {
1113
+ "type": "number"
1114
+ }
1115
+ ]
1116
+ },
1117
+ "aspects": {
1118
+ "type": "array",
1119
+ "items": {
1120
+ "type": "object",
1121
+ "properties": {
1122
+ "localizedAspectName": {
1123
+ "type": "string"
1124
+ },
1125
+ "aspectConstraint": {
1126
+ "type": "object",
1127
+ "properties": {
1128
+ "aspectDataType": {
1129
+ "type": "string",
1130
+ "enum": [
1131
+ "DATE",
1132
+ "NUMBER",
1133
+ "STRING",
1134
+ "TEXT"
1135
+ ]
1136
+ },
1137
+ "aspectEnabledForVariations": {
1138
+ "type": "boolean"
1139
+ },
1140
+ "aspectFormat": {
1141
+ "type": "string"
1142
+ },
1143
+ "aspectMaxLength": {
1144
+ "type": "number"
1145
+ },
1146
+ "aspectMode": {
1147
+ "type": "string",
1148
+ "enum": [
1149
+ "FREE_TEXT",
1150
+ "SELECTION_ONLY"
1151
+ ]
1152
+ },
1153
+ "aspectRequired": {
1154
+ "type": "boolean"
1155
+ },
1156
+ "aspectUsage": {
1157
+ "type": "string",
1158
+ "enum": [
1159
+ "RECOMMENDED",
1160
+ "OPTIONAL"
1161
+ ]
1162
+ },
1163
+ "expectedRequiredByDate": {
1164
+ "type": "string"
1165
+ },
1166
+ "itemToAspectCardinality": {
1167
+ "type": "string",
1168
+ "enum": [
1169
+ "MULTI",
1170
+ "SINGLE"
1171
+ ]
1172
+ }
1173
+ },
1174
+ "required": [
1175
+ "aspectDataType",
1176
+ "aspectEnabledForVariations",
1177
+ "aspectMode",
1178
+ "aspectRequired",
1179
+ "aspectUsage",
1180
+ "itemToAspectCardinality"
1181
+ ]
1182
+ },
1183
+ "aspectValues": {
1184
+ "type": "array",
1185
+ "items": {
1186
+ "type": "string"
1187
+ }
1188
+ },
1189
+ "relevanceIndicator": {
1190
+ "type": "object",
1191
+ "properties": {
1192
+ "searchCount": {
1193
+ "type": "number"
1194
+ }
1195
+ },
1196
+ "required": [
1197
+ "searchCount"
1198
+ ]
1199
+ }
1200
+ },
1201
+ "required": [
1202
+ "localizedAspectName",
1203
+ "aspectConstraint"
1204
+ ]
1205
+ }
1206
+ },
1207
+ "conditions": {
1208
+ "type": "array",
1209
+ "items": {
1210
+ "type": "object",
1211
+ "properties": {
1212
+ "id": {
1213
+ "type": "string"
1214
+ },
1215
+ "description": {
1216
+ "type": "string"
1217
+ }
1218
+ },
1219
+ "required": [
1220
+ "id"
1221
+ ]
1222
+ }
1223
+ }
1224
+ },
1225
+ "required": [
1226
+ "categoryId",
1227
+ "aspects",
1228
+ "conditions"
1229
+ ]
1230
+ }
1231
+ },
1232
+ "required": [
1233
+ "status",
1234
+ "data"
1235
+ ]
1236
+ }
1237
+ }
1238
+ }
1239
+ },
1240
+ "400": {
1241
+ "description": "Invalid request parameters",
1242
+ "content": {
1243
+ "application/json": {
1244
+ "schema": {
1245
+ "type": "object",
1246
+ "properties": {
1247
+ "error": {
1248
+ "type": "string"
1249
+ },
1250
+ "code": {
1251
+ "type": "string"
1252
+ },
1253
+ "details": {
1254
+ "type": "array",
1255
+ "items": {}
1256
+ }
1257
+ },
1258
+ "required": [
1259
+ "error",
1260
+ "code"
1261
+ ]
1262
+ }
1263
+ }
1264
+ }
1265
+ },
1266
+ "401": {
1267
+ "description": "Unauthorized - Invalid or missing eBay token",
1268
+ "content": {
1269
+ "application/json": {
1270
+ "schema": {
1271
+ "type": "object",
1272
+ "properties": {
1273
+ "error": {
1274
+ "type": "string"
1275
+ },
1276
+ "code": {
1277
+ "type": "string"
1278
+ },
1279
+ "details": {
1280
+ "type": "array",
1281
+ "items": {}
1282
+ }
1283
+ },
1284
+ "required": [
1285
+ "error",
1286
+ "code"
1287
+ ]
1288
+ }
1289
+ }
1290
+ }
1291
+ },
1292
+ "403": {
1293
+ "description": "Forbidden",
1294
+ "content": {
1295
+ "application/json": {
1296
+ "schema": {
1297
+ "type": "object",
1298
+ "properties": {
1299
+ "error": {
1300
+ "type": "string"
1301
+ },
1302
+ "code": {
1303
+ "type": "string"
1304
+ },
1305
+ "details": {
1306
+ "type": "array",
1307
+ "items": {}
1308
+ }
1309
+ },
1310
+ "required": [
1311
+ "error",
1312
+ "code"
1313
+ ]
1314
+ }
1315
+ }
1316
+ }
1317
+ },
1318
+ "404": {
1319
+ "description": "No aspects or conditions found for the category",
1320
+ "content": {
1321
+ "application/json": {
1322
+ "schema": {
1323
+ "type": "object",
1324
+ "properties": {
1325
+ "error": {
1326
+ "type": "string"
1327
+ },
1328
+ "code": {
1329
+ "type": "string"
1330
+ },
1331
+ "details": {
1332
+ "type": "array",
1333
+ "items": {}
1334
+ }
1335
+ },
1336
+ "required": [
1337
+ "error",
1338
+ "code"
1339
+ ]
1340
+ }
1341
+ }
1342
+ }
1343
+ },
1344
+ "500": {
1345
+ "description": "Internal server error",
1346
+ "content": {
1347
+ "application/json": {
1348
+ "schema": {
1349
+ "type": "object",
1350
+ "properties": {
1351
+ "error": {
1352
+ "type": "string"
1353
+ },
1354
+ "code": {
1355
+ "type": "string"
1356
+ },
1357
+ "details": {
1358
+ "type": "array",
1359
+ "items": {}
1360
+ }
1361
+ },
1362
+ "required": [
1363
+ "error",
1364
+ "code"
1365
+ ]
1366
+ }
1367
+ }
1368
+ }
1369
+ }
1370
+ },
1371
+ "operationId": "get_api_ebay_categories_listing_requirements_700b6d7f"
1372
+ }
1373
+ },
1374
+ "/api/ebay/listings/auction": {
1375
+ "post": {
1376
+ "tags": [
1377
+ "Listings"
1378
+ ],
1379
+ "summary": "Create a new auction listing",
1380
+ "description": "Creates a new auction listing on eBay with the specified details",
1381
+ "security": [
1382
+ {
1383
+ "bearer": [
1384
+ "https://api.ebay.com/oauth/api_scope/sell.inventory"
1385
+ ]
1386
+ }
1387
+ ],
1388
+ "parameters": [
1389
+ {
1390
+ "name": "userId",
1391
+ "in": "query",
1392
+ "required": true,
1393
+ "schema": {
1394
+ "type": "string",
1395
+ "description": "eBay user ID"
1396
+ },
1397
+ "description": "eBay user ID"
1398
+ }
1399
+ ],
1400
+ "requestBody": {
1401
+ "required": true,
1402
+ "content": {
1403
+ "application/json": {
1404
+ "schema": {
1405
+ "type": "object",
1406
+ "properties": {
1407
+ "title": {
1408
+ "type": "string",
1409
+ "minLength": 1,
1410
+ "maxLength": 80,
1411
+ "description": "Listing title"
1412
+ },
1413
+ "description": {
1414
+ "type": "string",
1415
+ "minLength": 1,
1416
+ "description": "Listing description"
1417
+ },
1418
+ "categoryId": {
1419
+ "type": "string",
1420
+ "description": "eBay category ID"
1421
+ },
1422
+ "conditionId": {
1423
+ "type": "number",
1424
+ "description": "Item condition ID"
1425
+ },
1426
+ "startPrice": {
1427
+ "type": "number",
1428
+ "exclusiveMinimum": 0,
1429
+ "description": "Starting price"
1430
+ },
1431
+ "buyItNowPrice": {
1432
+ "type": "number",
1433
+ "exclusiveMinimum": 0,
1434
+ "description": "Buy it now price"
1435
+ },
1436
+ "listingDuration": {
1437
+ "default": "Days_7",
1438
+ "type": "string",
1439
+ "description": "Duration of the listing"
1440
+ },
1441
+ "shippingCost": {
1442
+ "type": "number",
1443
+ "minimum": 0,
1444
+ "description": "Shipping cost"
1445
+ },
1446
+ "postalCode": {
1447
+ "type": "string",
1448
+ "description": "Postal code for shipping"
1449
+ },
1450
+ "dispatchTimeMax": {
1451
+ "type": "integer",
1452
+ "exclusiveMinimum": 0,
1453
+ "description": "Maximum dispatch time in days"
1454
+ },
1455
+ "images": {
1456
+ "description": "Images for the listing",
1457
+ "type": "object",
1458
+ "properties": {
1459
+ "base64": {
1460
+ "type": "array",
1461
+ "items": {
1462
+ "type": "string"
1463
+ },
1464
+ "description": "Array of base64 encoded images"
1465
+ },
1466
+ "urls": {
1467
+ "type": "array",
1468
+ "items": {
1469
+ "type": "string",
1470
+ "format": "uri"
1471
+ },
1472
+ "description": "Array of image URLs"
1473
+ }
1474
+ }
1475
+ }
1476
+ },
1477
+ "required": [
1478
+ "title",
1479
+ "description",
1480
+ "categoryId",
1481
+ "startPrice",
1482
+ "shippingCost",
1483
+ "postalCode",
1484
+ "dispatchTimeMax",
1485
+ "images"
1486
+ ]
1487
+ }
1488
+ }
1489
+ }
1490
+ },
1491
+ "responses": {
1492
+ "200": {
1493
+ "description": "Successful response",
1494
+ "content": {
1495
+ "application/json": {
1496
+ "schema": {
1497
+ "discriminator": {
1498
+ "propertyName": "status"
1499
+ },
1500
+ "oneOf": [
1501
+ {
1502
+ "type": "object",
1503
+ "properties": {
1504
+ "status": {
1505
+ "type": "string",
1506
+ "enum": [
1507
+ "success"
1508
+ ]
1509
+ },
1510
+ "data": {
1511
+ "type": "object",
1512
+ "properties": {
1513
+ "itemId": {
1514
+ "type": "string",
1515
+ "description": "eBay item ID"
1516
+ },
1517
+ "title": {
1518
+ "type": "string",
1519
+ "description": "Listing title"
1520
+ },
1521
+ "startTime": {
1522
+ "type": "string",
1523
+ "description": "Listing start time"
1524
+ },
1525
+ "endTime": {
1526
+ "type": "string",
1527
+ "description": "Listing end time"
1528
+ }
1529
+ },
1530
+ "required": [
1531
+ "itemId",
1532
+ "title",
1533
+ "startTime",
1534
+ "endTime"
1535
+ ]
1536
+ }
1537
+ },
1538
+ "required": [
1539
+ "status",
1540
+ "data"
1541
+ ]
1542
+ },
1543
+ {
1544
+ "type": "object",
1545
+ "properties": {
1546
+ "status": {
1547
+ "type": "string",
1548
+ "enum": [
1549
+ "error"
1550
+ ]
1551
+ },
1552
+ "message": {
1553
+ "type": "string"
1554
+ },
1555
+ "errorType": {
1556
+ "type": "string",
1557
+ "enum": [
1558
+ "VALIDATION_ERROR",
1559
+ "BUSINESS_POLICIES_ERROR",
1560
+ "EBAY_API_ERROR",
1561
+ "AUTH_ERROR",
1562
+ "INTERNAL_ERROR"
1563
+ ]
1564
+ },
1565
+ "errors": {
1566
+ "type": "array",
1567
+ "items": {}
1568
+ }
1569
+ },
1570
+ "required": [
1571
+ "status",
1572
+ "message",
1573
+ "errorType"
1574
+ ]
1575
+ }
1576
+ ]
1577
+ }
1578
+ }
1579
+ }
1580
+ },
1581
+ "400": {
1582
+ "description": "Invalid request parameters or eBay API validation error",
1583
+ "content": {
1584
+ "application/json": {
1585
+ "schema": {
1586
+ "type": "object",
1587
+ "properties": {
1588
+ "status": {
1589
+ "type": "string",
1590
+ "enum": [
1591
+ "error"
1592
+ ]
1593
+ },
1594
+ "message": {
1595
+ "type": "string"
1596
+ },
1597
+ "errorType": {
1598
+ "type": "string",
1599
+ "enum": [
1600
+ "VALIDATION_ERROR",
1601
+ "BUSINESS_POLICIES_ERROR",
1602
+ "EBAY_API_ERROR",
1603
+ "AUTH_ERROR",
1604
+ "INTERNAL_ERROR"
1605
+ ]
1606
+ },
1607
+ "errors": {
1608
+ "type": "array",
1609
+ "items": {}
1610
+ }
1611
+ },
1612
+ "required": [
1613
+ "status",
1614
+ "message",
1615
+ "errorType"
1616
+ ]
1617
+ }
1618
+ }
1619
+ }
1620
+ },
1621
+ "401": {
1622
+ "description": "Unauthorized - Invalid or missing eBay token",
1623
+ "content": {
1624
+ "application/json": {
1625
+ "schema": {
1626
+ "type": "object",
1627
+ "properties": {
1628
+ "error": {
1629
+ "type": "string"
1630
+ },
1631
+ "code": {
1632
+ "type": "string"
1633
+ },
1634
+ "details": {
1635
+ "type": "array",
1636
+ "items": {}
1637
+ }
1638
+ },
1639
+ "required": [
1640
+ "error",
1641
+ "code"
1642
+ ]
1643
+ }
1644
+ }
1645
+ }
1646
+ },
1647
+ "403": {
1648
+ "description": "Forbidden - Insufficient permissions or business policy error",
1649
+ "content": {
1650
+ "application/json": {
1651
+ "schema": {
1652
+ "type": "object",
1653
+ "properties": {
1654
+ "status": {
1655
+ "type": "string",
1656
+ "enum": [
1657
+ "error"
1658
+ ]
1659
+ },
1660
+ "message": {
1661
+ "type": "string"
1662
+ },
1663
+ "errorType": {
1664
+ "type": "string",
1665
+ "enum": [
1666
+ "VALIDATION_ERROR",
1667
+ "BUSINESS_POLICIES_ERROR",
1668
+ "EBAY_API_ERROR",
1669
+ "AUTH_ERROR",
1670
+ "INTERNAL_ERROR"
1671
+ ]
1672
+ },
1673
+ "errors": {
1674
+ "type": "array",
1675
+ "items": {}
1676
+ }
1677
+ },
1678
+ "required": [
1679
+ "status",
1680
+ "message",
1681
+ "errorType"
1682
+ ]
1683
+ }
1684
+ }
1685
+ }
1686
+ },
1687
+ "500": {
1688
+ "description": "Internal server error",
1689
+ "content": {
1690
+ "application/json": {
1691
+ "schema": {
1692
+ "type": "object",
1693
+ "properties": {
1694
+ "status": {
1695
+ "type": "string",
1696
+ "enum": [
1697
+ "error"
1698
+ ]
1699
+ },
1700
+ "message": {
1701
+ "type": "string"
1702
+ },
1703
+ "errorType": {
1704
+ "type": "string",
1705
+ "enum": [
1706
+ "VALIDATION_ERROR",
1707
+ "BUSINESS_POLICIES_ERROR",
1708
+ "EBAY_API_ERROR",
1709
+ "AUTH_ERROR",
1710
+ "INTERNAL_ERROR"
1711
+ ]
1712
+ },
1713
+ "errors": {
1714
+ "type": "array",
1715
+ "items": {}
1716
+ }
1717
+ },
1718
+ "required": [
1719
+ "status",
1720
+ "message",
1721
+ "errorType"
1722
+ ]
1723
+ }
1724
+ }
1725
+ }
1726
+ }
1727
+ },
1728
+ "operationId": "post_api_ebay_listings_auction_fe15420c",
1729
+ "x-openai-isConsequential": false
1730
+ }
1731
+ },
1732
+ "/api/listings/advanced": {
1733
+ "post": {
1734
+ "tags": [
1735
+ "Listings"
1736
+ ],
1737
+ "summary": "Create an advanced listing with full eBay Trading API support",
1738
+ "description": "Create a new eBay listing with advanced options including shipping, returns, and condition details",
1739
+ "parameters": [
1740
+ {
1741
+ "name": "site",
1742
+ "in": "query",
1743
+ "required": true,
1744
+ "schema": {
1745
+ "type": "string",
1746
+ "description": "The eBay site ID to list on"
1747
+ },
1748
+ "description": "The eBay site ID to list on"
1749
+ },
1750
+ {
1751
+ "name": "userId",
1752
+ "in": "query",
1753
+ "required": true,
1754
+ "schema": {
1755
+ "type": "string",
1756
+ "description": "The eBay user ID to authenticate as"
1757
+ },
1758
+ "description": "The eBay user ID to authenticate as"
1759
+ }
1760
+ ],
1761
+ "requestBody": {
1762
+ "required": true,
1763
+ "content": {
1764
+ "application/json": {
1765
+ "schema": {
1766
+ "type": "object",
1767
+ "properties": {
1768
+ "item": {
1769
+ "type": "object",
1770
+ "properties": {
1771
+ "title": {
1772
+ "type": "string"
1773
+ },
1774
+ "primaryCategory": {
1775
+ "type": "object",
1776
+ "properties": {
1777
+ "categoryId": {
1778
+ "type": "string"
1779
+ },
1780
+ "categoryName": {
1781
+ "type": "string"
1782
+ }
1783
+ },
1784
+ "required": [
1785
+ "categoryId"
1786
+ ]
1787
+ },
1788
+ "quantity": {
1789
+ "type": "integer"
1790
+ },
1791
+ "itemSpecifics": {
1792
+ "type": "object",
1793
+ "additionalProperties": {
1794
+ "oneOf": [
1795
+ {
1796
+ "type": "string"
1797
+ },
1798
+ {
1799
+ "type": "array",
1800
+ "items": {
1801
+ "type": "string"
1802
+ }
1803
+ }
1804
+ ]
1805
+ }
1806
+ },
1807
+ "startPrice": {
1808
+ "type": "object",
1809
+ "properties": {
1810
+ "value": {
1811
+ "type": "number"
1812
+ },
1813
+ "currencyId": {
1814
+ "type": "string"
1815
+ }
1816
+ },
1817
+ "required": [
1818
+ "value",
1819
+ "currencyId"
1820
+ ]
1821
+ },
1822
+ "description": {
1823
+ "type": "string"
1824
+ },
1825
+ "listingDuration": {
1826
+ "type": "string"
1827
+ },
1828
+ "listingType": {
1829
+ "type": "string"
1830
+ },
1831
+ "location": {
1832
+ "type": "string"
1833
+ },
1834
+ "country": {
1835
+ "type": "string"
1836
+ },
1837
+ "currency": {
1838
+ "type": "string"
1839
+ },
1840
+ "paymentMethods": {
1841
+ "type": "array",
1842
+ "items": {
1843
+ "type": "string"
1844
+ }
1845
+ },
1846
+ "dispatchTimeMax": {
1847
+ "default": 3,
1848
+ "type": "integer"
1849
+ },
1850
+ "pictureDetails": {
1851
+ "type": "object",
1852
+ "properties": {
1853
+ "galleryType": {
1854
+ "type": "string"
1855
+ },
1856
+ "pictureUrl": {
1857
+ "type": "array",
1858
+ "items": {
1859
+ "type": "string",
1860
+ "format": "uri"
1861
+ }
1862
+ }
1863
+ },
1864
+ "required": [
1865
+ "galleryType"
1866
+ ]
1867
+ },
1868
+ "returnPolicy": {
1869
+ "type": "object",
1870
+ "properties": {
1871
+ "returnsAcceptedOption": {
1872
+ "type": "string",
1873
+ "enum": [
1874
+ "ReturnsAccepted",
1875
+ "ReturnsNotAccepted"
1876
+ ]
1877
+ },
1878
+ "returnsWithinOption": {
1879
+ "type": "string"
1880
+ },
1881
+ "description": {
1882
+ "type": "string"
1883
+ }
1884
+ },
1885
+ "required": [
1886
+ "returnsAcceptedOption",
1887
+ "description"
1888
+ ]
1889
+ },
1890
+ "shippingDetails": {
1891
+ "type": "object",
1892
+ "properties": {
1893
+ "shippingType": {
1894
+ "type": "string"
1895
+ },
1896
+ "shippingServiceOptions": {
1897
+ "type": "array",
1898
+ "items": {
1899
+ "type": "object",
1900
+ "properties": {
1901
+ "shippingService": {
1902
+ "type": "string"
1903
+ },
1904
+ "shippingServiceCost": {
1905
+ "type": "object",
1906
+ "properties": {
1907
+ "value": {
1908
+ "type": "number"
1909
+ },
1910
+ "currencyId": {
1911
+ "type": "string"
1912
+ }
1913
+ },
1914
+ "required": [
1915
+ "value",
1916
+ "currencyId"
1917
+ ]
1918
+ },
1919
+ "freeShipping": {
1920
+ "type": "boolean"
1921
+ }
1922
+ },
1923
+ "required": [
1924
+ "shippingService"
1925
+ ]
1926
+ }
1927
+ }
1928
+ },
1929
+ "required": [
1930
+ "shippingType",
1931
+ "shippingServiceOptions"
1932
+ ]
1933
+ },
1934
+ "conditionId": {
1935
+ "type": "integer"
1936
+ },
1937
+ "conditionDescription": {
1938
+ "type": "string"
1939
+ }
1940
+ },
1941
+ "required": [
1942
+ "title",
1943
+ "primaryCategory",
1944
+ "quantity",
1945
+ "startPrice",
1946
+ "location"
1947
+ ]
1948
+ },
1949
+ "errorLanguage": {
1950
+ "type": "string"
1951
+ },
1952
+ "warningLevel": {
1953
+ "type": "string"
1954
+ }
1955
+ },
1956
+ "required": [
1957
+ "item"
1958
+ ]
1959
+ }
1960
+ }
1961
+ }
1962
+ },
1963
+ "responses": {
1964
+ "200": {
1965
+ "description": "Successful response",
1966
+ "content": {
1967
+ "application/json": {
1968
+ "schema": {
1969
+ "type": "object",
1970
+ "properties": {
1971
+ "itemId": {
1972
+ "type": "string"
1973
+ },
1974
+ "startTime": {
1975
+ "type": "string"
1976
+ },
1977
+ "endTime": {
1978
+ "type": "string"
1979
+ },
1980
+ "fees": {
1981
+ "type": "array",
1982
+ "items": {
1983
+ "type": "object",
1984
+ "properties": {
1985
+ "name": {
1986
+ "type": "string"
1987
+ },
1988
+ "fee": {
1989
+ "type": "object",
1990
+ "properties": {
1991
+ "value": {
1992
+ "type": "number"
1993
+ },
1994
+ "currencyId": {
1995
+ "type": "string"
1996
+ }
1997
+ },
1998
+ "required": [
1999
+ "value",
2000
+ "currencyId"
2001
+ ]
2002
+ }
2003
+ },
2004
+ "required": [
2005
+ "name",
2006
+ "fee"
2007
+ ]
2008
+ }
2009
+ },
2010
+ "category": {
2011
+ "type": "object",
2012
+ "properties": {
2013
+ "categoryId": {
2014
+ "type": "string"
2015
+ },
2016
+ "categoryName": {
2017
+ "type": "string"
2018
+ }
2019
+ },
2020
+ "required": [
2021
+ "categoryId"
2022
+ ]
2023
+ },
2024
+ "message": {
2025
+ "type": "string"
2026
+ }
2027
+ },
2028
+ "required": [
2029
+ "itemId",
2030
+ "startTime",
2031
+ "endTime",
2032
+ "fees",
2033
+ "category",
2034
+ "message"
2035
+ ]
2036
+ }
2037
+ }
2038
+ }
2039
+ },
2040
+ "400": {
2041
+ "description": "Invalid request parameters or eBay API validation error",
2042
+ "content": {
2043
+ "application/json": {
2044
+ "schema": {
2045
+ "type": "object",
2046
+ "properties": {
2047
+ "status": {
2048
+ "type": "string",
2049
+ "enum": [
2050
+ "error"
2051
+ ]
2052
+ },
2053
+ "message": {
2054
+ "type": "string"
2055
+ },
2056
+ "details": {
2057
+ "type": "string"
2058
+ },
2059
+ "errorType": {
2060
+ "type": "string",
2061
+ "enum": [
2062
+ "VALIDATION_ERROR",
2063
+ "BUSINESS_POLICIES_ERROR",
2064
+ "EBAY_API_ERROR",
2065
+ "AUTH_ERROR",
2066
+ "INTERNAL_ERROR"
2067
+ ]
2068
+ },
2069
+ "errors": {
2070
+ "type": "array",
2071
+ "items": {
2072
+ "type": "object",
2073
+ "properties": {
2074
+ "code": {
2075
+ "oneOf": [
2076
+ {
2077
+ "type": "string"
2078
+ },
2079
+ {
2080
+ "type": "number"
2081
+ }
2082
+ ]
2083
+ },
2084
+ "message": {
2085
+ "type": "string"
2086
+ },
2087
+ "severity": {
2088
+ "type": "string"
2089
+ },
2090
+ "classification": {
2091
+ "type": "string"
2092
+ }
2093
+ },
2094
+ "required": [
2095
+ "code",
2096
+ "message"
2097
+ ]
2098
+ }
2099
+ }
2100
+ },
2101
+ "required": [
2102
+ "status",
2103
+ "message",
2104
+ "errorType"
2105
+ ]
2106
+ }
2107
+ }
2108
+ }
2109
+ },
2110
+ "401": {
2111
+ "description": "Unauthorized - Invalid or missing eBay token",
2112
+ "content": {
2113
+ "application/json": {
2114
+ "schema": {
2115
+ "type": "object",
2116
+ "properties": {
2117
+ "status": {
2118
+ "type": "string",
2119
+ "enum": [
2120
+ "error"
2121
+ ]
2122
+ },
2123
+ "message": {
2124
+ "type": "string"
2125
+ },
2126
+ "details": {
2127
+ "type": "string"
2128
+ },
2129
+ "errorType": {
2130
+ "type": "string",
2131
+ "enum": [
2132
+ "VALIDATION_ERROR",
2133
+ "BUSINESS_POLICIES_ERROR",
2134
+ "EBAY_API_ERROR",
2135
+ "AUTH_ERROR",
2136
+ "INTERNAL_ERROR"
2137
+ ]
2138
+ },
2139
+ "errors": {
2140
+ "type": "array",
2141
+ "items": {
2142
+ "type": "object",
2143
+ "properties": {
2144
+ "code": {
2145
+ "oneOf": [
2146
+ {
2147
+ "type": "string"
2148
+ },
2149
+ {
2150
+ "type": "number"
2151
+ }
2152
+ ]
2153
+ },
2154
+ "message": {
2155
+ "type": "string"
2156
+ },
2157
+ "severity": {
2158
+ "type": "string"
2159
+ },
2160
+ "classification": {
2161
+ "type": "string"
2162
+ }
2163
+ },
2164
+ "required": [
2165
+ "code",
2166
+ "message"
2167
+ ]
2168
+ }
2169
+ }
2170
+ },
2171
+ "required": [
2172
+ "status",
2173
+ "message",
2174
+ "errorType"
2175
+ ]
2176
+ }
2177
+ }
2178
+ }
2179
+ },
2180
+ "403": {
2181
+ "description": "Forbidden - Insufficient permissions or business policy error",
2182
+ "content": {
2183
+ "application/json": {
2184
+ "schema": {
2185
+ "type": "object",
2186
+ "properties": {
2187
+ "status": {
2188
+ "type": "string",
2189
+ "enum": [
2190
+ "error"
2191
+ ]
2192
+ },
2193
+ "message": {
2194
+ "type": "string"
2195
+ },
2196
+ "details": {
2197
+ "type": "string"
2198
+ },
2199
+ "errorType": {
2200
+ "type": "string",
2201
+ "enum": [
2202
+ "VALIDATION_ERROR",
2203
+ "BUSINESS_POLICIES_ERROR",
2204
+ "EBAY_API_ERROR",
2205
+ "AUTH_ERROR",
2206
+ "INTERNAL_ERROR"
2207
+ ]
2208
+ },
2209
+ "errors": {
2210
+ "type": "array",
2211
+ "items": {
2212
+ "type": "object",
2213
+ "properties": {
2214
+ "code": {
2215
+ "oneOf": [
2216
+ {
2217
+ "type": "string"
2218
+ },
2219
+ {
2220
+ "type": "number"
2221
+ }
2222
+ ]
2223
+ },
2224
+ "message": {
2225
+ "type": "string"
2226
+ },
2227
+ "severity": {
2228
+ "type": "string"
2229
+ },
2230
+ "classification": {
2231
+ "type": "string"
2232
+ }
2233
+ },
2234
+ "required": [
2235
+ "code",
2236
+ "message"
2237
+ ]
2238
+ }
2239
+ }
2240
+ },
2241
+ "required": [
2242
+ "status",
2243
+ "message",
2244
+ "errorType"
2245
+ ]
2246
+ }
2247
+ }
2248
+ }
2249
+ },
2250
+ "500": {
2251
+ "description": "Internal server error",
2252
+ "content": {
2253
+ "application/json": {
2254
+ "schema": {
2255
+ "type": "object",
2256
+ "properties": {
2257
+ "status": {
2258
+ "type": "string",
2259
+ "enum": [
2260
+ "error"
2261
+ ]
2262
+ },
2263
+ "message": {
2264
+ "type": "string"
2265
+ },
2266
+ "details": {
2267
+ "type": "string"
2268
+ },
2269
+ "errorType": {
2270
+ "type": "string",
2271
+ "enum": [
2272
+ "VALIDATION_ERROR",
2273
+ "BUSINESS_POLICIES_ERROR",
2274
+ "EBAY_API_ERROR",
2275
+ "AUTH_ERROR",
2276
+ "INTERNAL_ERROR"
2277
+ ]
2278
+ },
2279
+ "errors": {
2280
+ "type": "array",
2281
+ "items": {
2282
+ "type": "object",
2283
+ "properties": {
2284
+ "code": {
2285
+ "oneOf": [
2286
+ {
2287
+ "type": "string"
2288
+ },
2289
+ {
2290
+ "type": "number"
2291
+ }
2292
+ ]
2293
+ },
2294
+ "message": {
2295
+ "type": "string"
2296
+ },
2297
+ "severity": {
2298
+ "type": "string"
2299
+ },
2300
+ "classification": {
2301
+ "type": "string"
2302
+ }
2303
+ },
2304
+ "required": [
2305
+ "code",
2306
+ "message"
2307
+ ]
2308
+ }
2309
+ }
2310
+ },
2311
+ "required": [
2312
+ "status",
2313
+ "message",
2314
+ "errorType"
2315
+ ]
2316
+ }
2317
+ }
2318
+ }
2319
+ }
2320
+ },
2321
+ "operationId": "post_api_listings_advanced_1cdf2764",
2322
+ "x-openai-isConsequential": false
2323
+ }
2324
+ },
2325
+ "/api/images/upload": {
2326
+ "post": {
2327
+ "tags": [
2328
+ "Images"
2329
+ ],
2330
+ "summary": "Upload multiple images",
2331
+ "description": "Upload one or more images using multipart/form-data. Accepts up to 12 image files (JPEG, PNG, GIF, WebP) with a maximum size of 5MB each. Use field name 'images' for the file uploads.",
2332
+ "parameters": [],
2333
+ "requestBody": {
2334
+ "required": true,
2335
+ "content": {
2336
+ "multipart/form-data": {
2337
+ "schema": {
2338
+ "type": "object",
2339
+ "properties": {
2340
+ "images": {
2341
+ "type": "array",
2342
+ "items": {
2343
+ "type": "string",
2344
+ "format": "binary"
2345
+ },
2346
+ "description": "Image files to upload. Supports JPEG, PNG, GIF, and WebP formats. Maximum 12 files, each up to 5MB."
2347
+ }
2348
+ },
2349
+ "required": [
2350
+ "images"
2351
+ ]
2352
+ }
2353
+ }
2354
+ }
2355
+ },
2356
+ "responses": {
2357
+ "200": {
2358
+ "description": "Successful response",
2359
+ "content": {
2360
+ "application/json": {
2361
+ "schema": {
2362
+ "discriminator": {
2363
+ "propertyName": "status"
2364
+ },
2365
+ "oneOf": [
2366
+ {
2367
+ "type": "object",
2368
+ "properties": {
2369
+ "status": {
2370
+ "type": "string",
2371
+ "enum": [
2372
+ "success"
2373
+ ]
2374
+ },
2375
+ "data": {
2376
+ "type": "object",
2377
+ "properties": {
2378
+ "urls": {
2379
+ "type": "array",
2380
+ "items": {
2381
+ "type": "string",
2382
+ "format": "uri"
2383
+ },
2384
+ "description": "URLs of the uploaded images"
2385
+ }
2386
+ },
2387
+ "required": [
2388
+ "urls"
2389
+ ]
2390
+ }
2391
+ },
2392
+ "required": [
2393
+ "status",
2394
+ "data"
2395
+ ]
2396
+ },
2397
+ {
2398
+ "type": "object",
2399
+ "properties": {
2400
+ "status": {
2401
+ "type": "string",
2402
+ "enum": [
2403
+ "error"
2404
+ ]
2405
+ },
2406
+ "message": {
2407
+ "type": "string"
2408
+ },
2409
+ "errorType": {
2410
+ "type": "string",
2411
+ "enum": [
2412
+ "VALIDATION_ERROR",
2413
+ "UPLOAD_ERROR",
2414
+ "INTERNAL_ERROR"
2415
+ ]
2416
+ }
2417
+ },
2418
+ "required": [
2419
+ "status",
2420
+ "message",
2421
+ "errorType"
2422
+ ]
2423
+ }
2424
+ ]
2425
+ }
2426
+ }
2427
+ }
2428
+ },
2429
+ "400": {
2430
+ "description": "Invalid request parameters or file validation error",
2431
+ "content": {
2432
+ "application/json": {
2433
+ "schema": {
2434
+ "type": "object",
2435
+ "properties": {
2436
+ "status": {
2437
+ "type": "string",
2438
+ "enum": [
2439
+ "error"
2440
+ ]
2441
+ },
2442
+ "message": {
2443
+ "type": "string"
2444
+ },
2445
+ "errorType": {
2446
+ "type": "string",
2447
+ "enum": [
2448
+ "VALIDATION_ERROR",
2449
+ "UPLOAD_ERROR",
2450
+ "INTERNAL_ERROR"
2451
+ ]
2452
+ }
2453
+ },
2454
+ "required": [
2455
+ "status",
2456
+ "message",
2457
+ "errorType"
2458
+ ]
2459
+ }
2460
+ }
2461
+ }
2462
+ },
2463
+ "401": {
2464
+ "description": "Unauthorized",
2465
+ "content": {
2466
+ "application/json": {
2467
+ "schema": {
2468
+ "type": "object",
2469
+ "properties": {
2470
+ "error": {
2471
+ "type": "string"
2472
+ },
2473
+ "code": {
2474
+ "type": "string"
2475
+ },
2476
+ "details": {
2477
+ "type": "array",
2478
+ "items": {}
2479
+ }
2480
+ },
2481
+ "required": [
2482
+ "error",
2483
+ "code"
2484
+ ]
2485
+ }
2486
+ }
2487
+ }
2488
+ },
2489
+ "403": {
2490
+ "description": "Forbidden",
2491
+ "content": {
2492
+ "application/json": {
2493
+ "schema": {
2494
+ "type": "object",
2495
+ "properties": {
2496
+ "error": {
2497
+ "type": "string"
2498
+ },
2499
+ "code": {
2500
+ "type": "string"
2501
+ },
2502
+ "details": {
2503
+ "type": "array",
2504
+ "items": {}
2505
+ }
2506
+ },
2507
+ "required": [
2508
+ "error",
2509
+ "code"
2510
+ ]
2511
+ }
2512
+ }
2513
+ }
2514
+ },
2515
+ "500": {
2516
+ "description": "Internal server error",
2517
+ "content": {
2518
+ "application/json": {
2519
+ "schema": {
2520
+ "type": "object",
2521
+ "properties": {
2522
+ "status": {
2523
+ "type": "string",
2524
+ "enum": [
2525
+ "error"
2526
+ ]
2527
+ },
2528
+ "message": {
2529
+ "type": "string"
2530
+ },
2531
+ "errorType": {
2532
+ "type": "string",
2533
+ "enum": [
2534
+ "VALIDATION_ERROR",
2535
+ "UPLOAD_ERROR",
2536
+ "INTERNAL_ERROR"
2537
+ ]
2538
+ }
2539
+ },
2540
+ "required": [
2541
+ "status",
2542
+ "message",
2543
+ "errorType"
2544
+ ]
2545
+ }
2546
+ }
2547
+ }
2548
+ }
2549
+ },
2550
+ "operationId": "post_api_images_upload_830cd0c4",
2551
+ "x-openai-isConsequential": false
2552
+ }
2553
+ }
2554
+ }
2555
+ }