@anyproto/anytype-mcp 1.0.1 → 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,3710 @@
1
+ {
2
+ "tools": {
3
+ "API": {
4
+ "methods": [
5
+ {
6
+ "name": "get_api_ebay_categories_top_level_833ef4a3",
7
+ "description": "Get top-level eBay categories\nError Responses:\n400: Invalid request parameters\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden\n500: Internal server error",
8
+ "inputSchema": {
9
+ "type": "object",
10
+ "properties": {
11
+ "userId": {
12
+ "type": "string",
13
+ "description": "eBay user ID"
14
+ },
15
+ "siteId": {
16
+ "type": "string",
17
+ "description": "eBay site ID (e.g., 'EBAY_US')"
18
+ }
19
+ },
20
+ "required": [
21
+ "userId",
22
+ "siteId"
23
+ ]
24
+ },
25
+ "returnSchema": {
26
+ "type": "object",
27
+ "properties": {
28
+ "status": {
29
+ "type": "string",
30
+ "enum": [
31
+ "success"
32
+ ]
33
+ },
34
+ "data": {
35
+ "type": "array",
36
+ "items": {
37
+ "type": "object",
38
+ "properties": {
39
+ "id": {
40
+ "description": "Category ID",
41
+ "oneOf": [
42
+ {
43
+ "type": "string"
44
+ },
45
+ {
46
+ "type": "number"
47
+ }
48
+ ]
49
+ },
50
+ "name": {
51
+ "type": "string",
52
+ "description": "Category name"
53
+ },
54
+ "level": {
55
+ "type": "number",
56
+ "description": "Category level in hierarchy"
57
+ },
58
+ "parentId": {
59
+ "description": "Parent category ID",
60
+ "oneOf": [
61
+ {
62
+ "type": "string"
63
+ },
64
+ {
65
+ "type": "number"
66
+ }
67
+ ]
68
+ },
69
+ "isLeaf": {
70
+ "type": "boolean",
71
+ "description": "Whether this is a leaf category"
72
+ },
73
+ "fullPath": {
74
+ "type": "string",
75
+ "description": "Full category path"
76
+ },
77
+ "parentIds": {
78
+ "type": "array",
79
+ "description": "Array of parent category IDs",
80
+ "items": {
81
+ "oneOf": [
82
+ {
83
+ "type": "string"
84
+ },
85
+ {
86
+ "type": "number"
87
+ }
88
+ ]
89
+ }
90
+ }
91
+ },
92
+ "required": [
93
+ "id",
94
+ "name",
95
+ "level",
96
+ "parentId",
97
+ "isLeaf"
98
+ ],
99
+ "additionalProperties": true
100
+ }
101
+ }
102
+ },
103
+ "required": [
104
+ "status",
105
+ "data"
106
+ ],
107
+ "additionalProperties": true,
108
+ "description": "Successful response"
109
+ }
110
+ },
111
+ {
112
+ "name": "get_api_ebay_categories_leaves_3ea8b601",
113
+ "description": "Get leaf categories\nError Responses:\n400: Invalid request parameters\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden\n500: Internal server error",
114
+ "inputSchema": {
115
+ "type": "object",
116
+ "properties": {
117
+ "categoryId": {
118
+ "type": "string",
119
+ "description": "Parent category ID"
120
+ },
121
+ "userId": {
122
+ "type": "string",
123
+ "description": "eBay user ID"
124
+ },
125
+ "siteId": {
126
+ "type": "string",
127
+ "description": "eBay site ID (e.g., 'EBAY_US')"
128
+ }
129
+ },
130
+ "required": [
131
+ "categoryId",
132
+ "userId",
133
+ "siteId"
134
+ ]
135
+ },
136
+ "returnSchema": {
137
+ "type": "object",
138
+ "properties": {
139
+ "status": {
140
+ "type": "string",
141
+ "enum": [
142
+ "success"
143
+ ]
144
+ },
145
+ "data": {
146
+ "type": "array",
147
+ "items": {
148
+ "type": "object",
149
+ "properties": {
150
+ "id": {
151
+ "description": "Category ID",
152
+ "oneOf": [
153
+ {
154
+ "type": "string"
155
+ },
156
+ {
157
+ "type": "number"
158
+ }
159
+ ]
160
+ },
161
+ "name": {
162
+ "type": "string",
163
+ "description": "Category name"
164
+ },
165
+ "level": {
166
+ "type": "number",
167
+ "description": "Category level in hierarchy"
168
+ },
169
+ "parentId": {
170
+ "description": "Parent category ID",
171
+ "oneOf": [
172
+ {
173
+ "type": "string"
174
+ },
175
+ {
176
+ "type": "number"
177
+ }
178
+ ]
179
+ },
180
+ "isLeaf": {
181
+ "type": "boolean",
182
+ "description": "Whether this is a leaf category"
183
+ },
184
+ "fullPath": {
185
+ "type": "string",
186
+ "description": "Full category path"
187
+ },
188
+ "parentIds": {
189
+ "type": "array",
190
+ "description": "Array of parent category IDs",
191
+ "items": {
192
+ "oneOf": [
193
+ {
194
+ "type": "string"
195
+ },
196
+ {
197
+ "type": "number"
198
+ }
199
+ ]
200
+ }
201
+ }
202
+ },
203
+ "required": [
204
+ "id",
205
+ "name",
206
+ "level",
207
+ "parentId",
208
+ "isLeaf"
209
+ ],
210
+ "additionalProperties": true
211
+ }
212
+ }
213
+ },
214
+ "required": [
215
+ "status",
216
+ "data"
217
+ ],
218
+ "additionalProperties": true,
219
+ "description": "Successful response"
220
+ }
221
+ },
222
+ {
223
+ "name": "get_api_ebay_categories_conditions_0196f1da",
224
+ "description": "Get category condition policies\nError Responses:\n400: Invalid request parameters\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden\n404: No condition policies found for the category\n500: Internal server error",
225
+ "inputSchema": {
226
+ "type": "object",
227
+ "properties": {
228
+ "categoryId": {
229
+ "type": "string",
230
+ "description": "Category ID"
231
+ },
232
+ "userId": {
233
+ "type": "string",
234
+ "description": "eBay user ID"
235
+ },
236
+ "marketplaceId": {
237
+ "type": "string",
238
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
239
+ }
240
+ },
241
+ "required": [
242
+ "categoryId",
243
+ "userId",
244
+ "marketplaceId"
245
+ ]
246
+ },
247
+ "returnSchema": {
248
+ "type": "object",
249
+ "properties": {
250
+ "status": {
251
+ "type": "string",
252
+ "enum": [
253
+ "success"
254
+ ]
255
+ },
256
+ "data": {
257
+ "type": "object",
258
+ "properties": {
259
+ "categoryId": {
260
+ "description": "The category ID",
261
+ "oneOf": [
262
+ {
263
+ "type": "string"
264
+ },
265
+ {
266
+ "type": "number"
267
+ }
268
+ ]
269
+ },
270
+ "conditionDescriptors": {
271
+ "type": "array",
272
+ "items": {
273
+ "type": "object",
274
+ "properties": {
275
+ "id": {
276
+ "type": "string",
277
+ "description": "The condition ID"
278
+ },
279
+ "description": {
280
+ "type": "string",
281
+ "description": "Description of the condition"
282
+ }
283
+ },
284
+ "required": [
285
+ "id"
286
+ ],
287
+ "additionalProperties": true
288
+ }
289
+ }
290
+ },
291
+ "required": [
292
+ "categoryId",
293
+ "conditionDescriptors"
294
+ ],
295
+ "additionalProperties": true
296
+ }
297
+ },
298
+ "required": [
299
+ "status",
300
+ "data"
301
+ ],
302
+ "additionalProperties": true,
303
+ "description": "Successful response"
304
+ }
305
+ },
306
+ {
307
+ "name": "get_api_ebay_categories_aspects_59d62e7d",
308
+ "description": "Get category aspects\nError Responses:\n400: Invalid request parameters\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden\n404: No aspects found for the category\n500: Internal server error",
309
+ "inputSchema": {
310
+ "type": "object",
311
+ "properties": {
312
+ "categoryId": {
313
+ "type": "string",
314
+ "description": "Category ID"
315
+ },
316
+ "userId": {
317
+ "type": "string",
318
+ "description": "eBay user ID"
319
+ },
320
+ "marketplaceId": {
321
+ "type": "string",
322
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
323
+ }
324
+ },
325
+ "required": [
326
+ "categoryId",
327
+ "userId",
328
+ "marketplaceId"
329
+ ]
330
+ },
331
+ "returnSchema": {
332
+ "type": "object",
333
+ "properties": {
334
+ "status": {
335
+ "type": "string",
336
+ "enum": [
337
+ "success"
338
+ ]
339
+ },
340
+ "data": {
341
+ "type": "object",
342
+ "properties": {
343
+ "aspects": {
344
+ "type": "array",
345
+ "items": {
346
+ "type": "object",
347
+ "properties": {
348
+ "localizedAspectName": {
349
+ "type": "string"
350
+ },
351
+ "aspectConstraint": {
352
+ "type": "object",
353
+ "properties": {
354
+ "aspectDataType": {
355
+ "type": "string",
356
+ "enum": [
357
+ "DATE",
358
+ "NUMBER",
359
+ "STRING",
360
+ "TEXT"
361
+ ]
362
+ },
363
+ "aspectEnabledForVariations": {
364
+ "type": "boolean"
365
+ },
366
+ "aspectFormat": {
367
+ "type": "string"
368
+ },
369
+ "aspectMaxLength": {
370
+ "type": "number"
371
+ },
372
+ "aspectMode": {
373
+ "type": "string",
374
+ "enum": [
375
+ "FREE_TEXT",
376
+ "SELECTION_ONLY"
377
+ ]
378
+ },
379
+ "aspectRequired": {
380
+ "type": "boolean"
381
+ },
382
+ "aspectUsage": {
383
+ "type": "string",
384
+ "enum": [
385
+ "RECOMMENDED",
386
+ "OPTIONAL"
387
+ ]
388
+ },
389
+ "expectedRequiredByDate": {
390
+ "type": "string"
391
+ },
392
+ "itemToAspectCardinality": {
393
+ "type": "string",
394
+ "enum": [
395
+ "MULTI",
396
+ "SINGLE"
397
+ ]
398
+ }
399
+ },
400
+ "required": [
401
+ "aspectDataType",
402
+ "aspectEnabledForVariations",
403
+ "aspectMode",
404
+ "aspectRequired",
405
+ "aspectUsage",
406
+ "itemToAspectCardinality"
407
+ ],
408
+ "additionalProperties": true
409
+ },
410
+ "aspectValues": {
411
+ "type": "array",
412
+ "items": {
413
+ "type": "string"
414
+ }
415
+ },
416
+ "relevanceIndicator": {
417
+ "type": "object",
418
+ "properties": {
419
+ "searchCount": {
420
+ "type": "number"
421
+ }
422
+ },
423
+ "required": [
424
+ "searchCount"
425
+ ],
426
+ "additionalProperties": true
427
+ }
428
+ },
429
+ "required": [
430
+ "localizedAspectName",
431
+ "aspectConstraint"
432
+ ],
433
+ "additionalProperties": true
434
+ }
435
+ }
436
+ },
437
+ "required": [
438
+ "aspects"
439
+ ],
440
+ "additionalProperties": true
441
+ }
442
+ },
443
+ "required": [
444
+ "status",
445
+ "data"
446
+ ],
447
+ "additionalProperties": true,
448
+ "description": "Successful response"
449
+ }
450
+ },
451
+ {
452
+ "name": "get_api_ebay_categories_listing_requirements_700b6d7f",
453
+ "description": "Get category listing requirements\nError Responses:\n400: Invalid request parameters\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden\n404: No aspects or conditions found for the category\n500: Internal server error",
454
+ "inputSchema": {
455
+ "type": "object",
456
+ "properties": {
457
+ "categoryId": {
458
+ "type": "string",
459
+ "description": "Category ID"
460
+ },
461
+ "userId": {
462
+ "type": "string",
463
+ "description": "eBay user ID"
464
+ },
465
+ "marketplaceId": {
466
+ "type": "string",
467
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
468
+ }
469
+ },
470
+ "required": [
471
+ "categoryId",
472
+ "userId",
473
+ "marketplaceId"
474
+ ]
475
+ },
476
+ "returnSchema": {
477
+ "type": "object",
478
+ "properties": {
479
+ "status": {
480
+ "type": "string",
481
+ "enum": [
482
+ "success"
483
+ ]
484
+ },
485
+ "data": {
486
+ "type": "object",
487
+ "properties": {
488
+ "categoryId": {
489
+ "oneOf": [
490
+ {
491
+ "type": "string"
492
+ },
493
+ {
494
+ "type": "number"
495
+ }
496
+ ]
497
+ },
498
+ "aspects": {
499
+ "type": "array",
500
+ "items": {
501
+ "type": "object",
502
+ "properties": {
503
+ "localizedAspectName": {
504
+ "type": "string"
505
+ },
506
+ "aspectConstraint": {
507
+ "type": "object",
508
+ "properties": {
509
+ "aspectDataType": {
510
+ "type": "string",
511
+ "enum": [
512
+ "DATE",
513
+ "NUMBER",
514
+ "STRING",
515
+ "TEXT"
516
+ ]
517
+ },
518
+ "aspectEnabledForVariations": {
519
+ "type": "boolean"
520
+ },
521
+ "aspectFormat": {
522
+ "type": "string"
523
+ },
524
+ "aspectMaxLength": {
525
+ "type": "number"
526
+ },
527
+ "aspectMode": {
528
+ "type": "string",
529
+ "enum": [
530
+ "FREE_TEXT",
531
+ "SELECTION_ONLY"
532
+ ]
533
+ },
534
+ "aspectRequired": {
535
+ "type": "boolean"
536
+ },
537
+ "aspectUsage": {
538
+ "type": "string",
539
+ "enum": [
540
+ "RECOMMENDED",
541
+ "OPTIONAL"
542
+ ]
543
+ },
544
+ "expectedRequiredByDate": {
545
+ "type": "string"
546
+ },
547
+ "itemToAspectCardinality": {
548
+ "type": "string",
549
+ "enum": [
550
+ "MULTI",
551
+ "SINGLE"
552
+ ]
553
+ }
554
+ },
555
+ "required": [
556
+ "aspectDataType",
557
+ "aspectEnabledForVariations",
558
+ "aspectMode",
559
+ "aspectRequired",
560
+ "aspectUsage",
561
+ "itemToAspectCardinality"
562
+ ],
563
+ "additionalProperties": true
564
+ },
565
+ "aspectValues": {
566
+ "type": "array",
567
+ "items": {
568
+ "type": "string"
569
+ }
570
+ },
571
+ "relevanceIndicator": {
572
+ "type": "object",
573
+ "properties": {
574
+ "searchCount": {
575
+ "type": "number"
576
+ }
577
+ },
578
+ "required": [
579
+ "searchCount"
580
+ ],
581
+ "additionalProperties": true
582
+ }
583
+ },
584
+ "required": [
585
+ "localizedAspectName",
586
+ "aspectConstraint"
587
+ ],
588
+ "additionalProperties": true
589
+ }
590
+ },
591
+ "conditions": {
592
+ "type": "array",
593
+ "items": {
594
+ "type": "object",
595
+ "properties": {
596
+ "id": {
597
+ "type": "string"
598
+ },
599
+ "description": {
600
+ "type": "string"
601
+ }
602
+ },
603
+ "required": [
604
+ "id"
605
+ ],
606
+ "additionalProperties": true
607
+ }
608
+ }
609
+ },
610
+ "required": [
611
+ "categoryId",
612
+ "aspects",
613
+ "conditions"
614
+ ],
615
+ "additionalProperties": true
616
+ }
617
+ },
618
+ "required": [
619
+ "status",
620
+ "data"
621
+ ],
622
+ "additionalProperties": true,
623
+ "description": "Successful response"
624
+ }
625
+ },
626
+ {
627
+ "name": "post_api_ebay_listings_auction_fe15420c",
628
+ "description": "Create a new auction listing\nError Responses:\n400: Invalid request parameters or eBay API validation error\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden - Insufficient permissions or business policy error\n500: Internal server error",
629
+ "inputSchema": {
630
+ "type": "object",
631
+ "properties": {
632
+ "userId": {
633
+ "type": "string",
634
+ "description": "eBay user ID"
635
+ },
636
+ "title": {
637
+ "type": "string",
638
+ "description": "Listing title"
639
+ },
640
+ "description": {
641
+ "type": "string",
642
+ "description": "Listing description"
643
+ },
644
+ "categoryId": {
645
+ "type": "string",
646
+ "description": "eBay category ID"
647
+ },
648
+ "conditionId": {
649
+ "type": "number",
650
+ "description": "Item condition ID"
651
+ },
652
+ "startPrice": {
653
+ "type": "number",
654
+ "description": "Starting price"
655
+ },
656
+ "buyItNowPrice": {
657
+ "type": "number",
658
+ "description": "Buy it now price"
659
+ },
660
+ "listingDuration": {
661
+ "type": "string",
662
+ "description": "Duration of the listing",
663
+ "default": "Days_7"
664
+ },
665
+ "shippingCost": {
666
+ "type": "number",
667
+ "description": "Shipping cost"
668
+ },
669
+ "postalCode": {
670
+ "type": "string",
671
+ "description": "Postal code for shipping"
672
+ },
673
+ "dispatchTimeMax": {
674
+ "type": "integer",
675
+ "description": "Maximum dispatch time in days"
676
+ },
677
+ "images": {
678
+ "type": "object",
679
+ "description": "Images for the listing",
680
+ "properties": {
681
+ "base64": {
682
+ "type": "array",
683
+ "description": "Array of base64 encoded images",
684
+ "items": {
685
+ "type": "string"
686
+ }
687
+ },
688
+ "urls": {
689
+ "type": "array",
690
+ "description": "Array of image URLs",
691
+ "items": {
692
+ "type": "string",
693
+ "format": "uri"
694
+ }
695
+ }
696
+ },
697
+ "additionalProperties": true
698
+ }
699
+ },
700
+ "required": [
701
+ "userId",
702
+ "title",
703
+ "description",
704
+ "categoryId",
705
+ "startPrice",
706
+ "shippingCost",
707
+ "postalCode",
708
+ "dispatchTimeMax",
709
+ "images"
710
+ ]
711
+ },
712
+ "returnSchema": {
713
+ "oneOf": [
714
+ {
715
+ "type": "object",
716
+ "properties": {
717
+ "status": {
718
+ "type": "string",
719
+ "enum": [
720
+ "success"
721
+ ]
722
+ },
723
+ "data": {
724
+ "type": "object",
725
+ "properties": {
726
+ "itemId": {
727
+ "type": "string",
728
+ "description": "eBay item ID"
729
+ },
730
+ "title": {
731
+ "type": "string",
732
+ "description": "Listing title"
733
+ },
734
+ "startTime": {
735
+ "type": "string",
736
+ "description": "Listing start time"
737
+ },
738
+ "endTime": {
739
+ "type": "string",
740
+ "description": "Listing end time"
741
+ }
742
+ },
743
+ "required": [
744
+ "itemId",
745
+ "title",
746
+ "startTime",
747
+ "endTime"
748
+ ],
749
+ "additionalProperties": true
750
+ }
751
+ },
752
+ "required": [
753
+ "status",
754
+ "data"
755
+ ],
756
+ "additionalProperties": true
757
+ },
758
+ {
759
+ "type": "object",
760
+ "properties": {
761
+ "status": {
762
+ "type": "string",
763
+ "enum": [
764
+ "error"
765
+ ]
766
+ },
767
+ "message": {
768
+ "type": "string"
769
+ },
770
+ "errorType": {
771
+ "type": "string",
772
+ "enum": [
773
+ "VALIDATION_ERROR",
774
+ "BUSINESS_POLICIES_ERROR",
775
+ "EBAY_API_ERROR",
776
+ "AUTH_ERROR",
777
+ "INTERNAL_ERROR"
778
+ ]
779
+ },
780
+ "errors": {
781
+ "type": "array",
782
+ "items": {}
783
+ }
784
+ },
785
+ "required": [
786
+ "status",
787
+ "message",
788
+ "errorType"
789
+ ],
790
+ "additionalProperties": true
791
+ }
792
+ ],
793
+ "description": "Successful response"
794
+ }
795
+ },
796
+ {
797
+ "name": "post_api_listings_advanced_1cdf2764",
798
+ "description": "Create an advanced listing with full eBay Trading API support\nError Responses:\n400: Invalid request parameters or eBay API validation error\n401: Unauthorized - Invalid or missing eBay token\n403: Forbidden - Insufficient permissions or business policy error\n500: Internal server error",
799
+ "inputSchema": {
800
+ "type": "object",
801
+ "properties": {
802
+ "site": {
803
+ "type": "string",
804
+ "description": "The eBay site ID to list on"
805
+ },
806
+ "userId": {
807
+ "type": "string",
808
+ "description": "The eBay user ID to authenticate as"
809
+ },
810
+ "item": {
811
+ "type": "object",
812
+ "properties": {
813
+ "title": {
814
+ "type": "string"
815
+ },
816
+ "primaryCategory": {
817
+ "type": "object",
818
+ "properties": {
819
+ "categoryId": {
820
+ "type": "string"
821
+ },
822
+ "categoryName": {
823
+ "type": "string"
824
+ }
825
+ },
826
+ "required": [
827
+ "categoryId"
828
+ ],
829
+ "additionalProperties": true
830
+ },
831
+ "quantity": {
832
+ "type": "integer"
833
+ },
834
+ "itemSpecifics": {
835
+ "type": "object",
836
+ "additionalProperties": {
837
+ "oneOf": [
838
+ {
839
+ "type": "string"
840
+ },
841
+ {
842
+ "type": "array",
843
+ "items": {
844
+ "type": "string"
845
+ }
846
+ }
847
+ ]
848
+ }
849
+ },
850
+ "startPrice": {
851
+ "type": "object",
852
+ "properties": {
853
+ "value": {
854
+ "type": "number"
855
+ },
856
+ "currencyId": {
857
+ "type": "string"
858
+ }
859
+ },
860
+ "required": [
861
+ "value",
862
+ "currencyId"
863
+ ],
864
+ "additionalProperties": true
865
+ },
866
+ "description": {
867
+ "type": "string"
868
+ },
869
+ "listingDuration": {
870
+ "type": "string"
871
+ },
872
+ "listingType": {
873
+ "type": "string"
874
+ },
875
+ "location": {
876
+ "type": "string"
877
+ },
878
+ "country": {
879
+ "type": "string"
880
+ },
881
+ "currency": {
882
+ "type": "string"
883
+ },
884
+ "paymentMethods": {
885
+ "type": "array",
886
+ "items": {
887
+ "type": "string"
888
+ }
889
+ },
890
+ "dispatchTimeMax": {
891
+ "type": "integer",
892
+ "default": 3
893
+ },
894
+ "pictureDetails": {
895
+ "type": "object",
896
+ "properties": {
897
+ "galleryType": {
898
+ "type": "string"
899
+ },
900
+ "pictureUrl": {
901
+ "type": "array",
902
+ "items": {
903
+ "type": "string",
904
+ "format": "uri"
905
+ }
906
+ }
907
+ },
908
+ "required": [
909
+ "galleryType"
910
+ ],
911
+ "additionalProperties": true
912
+ },
913
+ "returnPolicy": {
914
+ "type": "object",
915
+ "properties": {
916
+ "returnsAcceptedOption": {
917
+ "type": "string",
918
+ "enum": [
919
+ "ReturnsAccepted",
920
+ "ReturnsNotAccepted"
921
+ ]
922
+ },
923
+ "returnsWithinOption": {
924
+ "type": "string"
925
+ },
926
+ "description": {
927
+ "type": "string"
928
+ }
929
+ },
930
+ "required": [
931
+ "returnsAcceptedOption",
932
+ "description"
933
+ ],
934
+ "additionalProperties": true
935
+ },
936
+ "shippingDetails": {
937
+ "type": "object",
938
+ "properties": {
939
+ "shippingType": {
940
+ "type": "string"
941
+ },
942
+ "shippingServiceOptions": {
943
+ "type": "array",
944
+ "items": {
945
+ "type": "object",
946
+ "properties": {
947
+ "shippingService": {
948
+ "type": "string"
949
+ },
950
+ "shippingServiceCost": {
951
+ "type": "object",
952
+ "properties": {
953
+ "value": {
954
+ "type": "number"
955
+ },
956
+ "currencyId": {
957
+ "type": "string"
958
+ }
959
+ },
960
+ "required": [
961
+ "value",
962
+ "currencyId"
963
+ ],
964
+ "additionalProperties": true
965
+ },
966
+ "freeShipping": {
967
+ "type": "boolean"
968
+ }
969
+ },
970
+ "required": [
971
+ "shippingService"
972
+ ],
973
+ "additionalProperties": true
974
+ }
975
+ }
976
+ },
977
+ "required": [
978
+ "shippingType",
979
+ "shippingServiceOptions"
980
+ ],
981
+ "additionalProperties": true
982
+ },
983
+ "conditionId": {
984
+ "type": "integer"
985
+ },
986
+ "conditionDescription": {
987
+ "type": "string"
988
+ }
989
+ },
990
+ "required": [
991
+ "title",
992
+ "primaryCategory",
993
+ "quantity",
994
+ "startPrice",
995
+ "location"
996
+ ],
997
+ "additionalProperties": true
998
+ },
999
+ "errorLanguage": {
1000
+ "type": "string"
1001
+ },
1002
+ "warningLevel": {
1003
+ "type": "string"
1004
+ }
1005
+ },
1006
+ "required": [
1007
+ "site",
1008
+ "userId",
1009
+ "item"
1010
+ ]
1011
+ },
1012
+ "returnSchema": {
1013
+ "type": "object",
1014
+ "properties": {
1015
+ "itemId": {
1016
+ "type": "string"
1017
+ },
1018
+ "startTime": {
1019
+ "type": "string"
1020
+ },
1021
+ "endTime": {
1022
+ "type": "string"
1023
+ },
1024
+ "fees": {
1025
+ "type": "array",
1026
+ "items": {
1027
+ "type": "object",
1028
+ "properties": {
1029
+ "name": {
1030
+ "type": "string"
1031
+ },
1032
+ "fee": {
1033
+ "type": "object",
1034
+ "properties": {
1035
+ "value": {
1036
+ "type": "number"
1037
+ },
1038
+ "currencyId": {
1039
+ "type": "string"
1040
+ }
1041
+ },
1042
+ "required": [
1043
+ "value",
1044
+ "currencyId"
1045
+ ],
1046
+ "additionalProperties": true
1047
+ }
1048
+ },
1049
+ "required": [
1050
+ "name",
1051
+ "fee"
1052
+ ],
1053
+ "additionalProperties": true
1054
+ }
1055
+ },
1056
+ "category": {
1057
+ "type": "object",
1058
+ "properties": {
1059
+ "categoryId": {
1060
+ "type": "string"
1061
+ },
1062
+ "categoryName": {
1063
+ "type": "string"
1064
+ }
1065
+ },
1066
+ "required": [
1067
+ "categoryId"
1068
+ ],
1069
+ "additionalProperties": true
1070
+ },
1071
+ "message": {
1072
+ "type": "string"
1073
+ }
1074
+ },
1075
+ "required": [
1076
+ "itemId",
1077
+ "startTime",
1078
+ "endTime",
1079
+ "fees",
1080
+ "category",
1081
+ "message"
1082
+ ],
1083
+ "additionalProperties": true,
1084
+ "description": "Successful response"
1085
+ }
1086
+ },
1087
+ {
1088
+ "name": "post_api_images_upload_830cd0c4",
1089
+ "description": "Upload multiple images\nError Responses:\n400: Invalid request parameters or file validation error\n401: Unauthorized\n403: Forbidden\n500: Internal server error",
1090
+ "inputSchema": {
1091
+ "type": "object",
1092
+ "properties": {
1093
+ "images": {
1094
+ "type": "array",
1095
+ "description": "Image files to upload. Supports JPEG, PNG, GIF, and WebP formats. Maximum 12 files, each up to 5MB.",
1096
+ "items": {
1097
+ "type": "string",
1098
+ "format": "uri-reference",
1099
+ "description": "absolute paths to local files"
1100
+ }
1101
+ }
1102
+ },
1103
+ "required": [
1104
+ "images"
1105
+ ]
1106
+ },
1107
+ "returnSchema": {
1108
+ "oneOf": [
1109
+ {
1110
+ "type": "object",
1111
+ "properties": {
1112
+ "status": {
1113
+ "type": "string",
1114
+ "enum": [
1115
+ "success"
1116
+ ]
1117
+ },
1118
+ "data": {
1119
+ "type": "object",
1120
+ "properties": {
1121
+ "urls": {
1122
+ "type": "array",
1123
+ "description": "URLs of the uploaded images",
1124
+ "items": {
1125
+ "type": "string",
1126
+ "format": "uri"
1127
+ }
1128
+ }
1129
+ },
1130
+ "required": [
1131
+ "urls"
1132
+ ],
1133
+ "additionalProperties": true
1134
+ }
1135
+ },
1136
+ "required": [
1137
+ "status",
1138
+ "data"
1139
+ ],
1140
+ "additionalProperties": true
1141
+ },
1142
+ {
1143
+ "type": "object",
1144
+ "properties": {
1145
+ "status": {
1146
+ "type": "string",
1147
+ "enum": [
1148
+ "error"
1149
+ ]
1150
+ },
1151
+ "message": {
1152
+ "type": "string"
1153
+ },
1154
+ "errorType": {
1155
+ "type": "string",
1156
+ "enum": [
1157
+ "VALIDATION_ERROR",
1158
+ "UPLOAD_ERROR",
1159
+ "INTERNAL_ERROR"
1160
+ ]
1161
+ }
1162
+ },
1163
+ "required": [
1164
+ "status",
1165
+ "message",
1166
+ "errorType"
1167
+ ],
1168
+ "additionalProperties": true
1169
+ }
1170
+ ],
1171
+ "description": "Successful response"
1172
+ }
1173
+ }
1174
+ ]
1175
+ }
1176
+ },
1177
+ "openApiLookup": {
1178
+ "API-get_api_ebay_categories_top_level_833ef4a3": {
1179
+ "tags": [
1180
+ "Categories"
1181
+ ],
1182
+ "summary": "Get top-level eBay categories",
1183
+ "description": "Returns a list of all top-level categories for the specified eBay site",
1184
+ "security": [
1185
+ {
1186
+ "bearer": [
1187
+ "https://api.ebay.com/oauth/api_scope"
1188
+ ]
1189
+ }
1190
+ ],
1191
+ "parameters": [
1192
+ {
1193
+ "name": "userId",
1194
+ "in": "query",
1195
+ "required": true,
1196
+ "schema": {
1197
+ "type": "string",
1198
+ "description": "eBay user ID"
1199
+ },
1200
+ "description": "eBay user ID"
1201
+ },
1202
+ {
1203
+ "name": "siteId",
1204
+ "in": "query",
1205
+ "required": true,
1206
+ "schema": {
1207
+ "type": "string",
1208
+ "description": "eBay site ID (e.g., 'EBAY_US')"
1209
+ },
1210
+ "description": "eBay site ID (e.g., 'EBAY_US')"
1211
+ }
1212
+ ],
1213
+ "responses": {
1214
+ "200": {
1215
+ "description": "Successful response",
1216
+ "content": {
1217
+ "application/json": {
1218
+ "schema": {
1219
+ "type": "object",
1220
+ "properties": {
1221
+ "status": {
1222
+ "type": "string",
1223
+ "enum": [
1224
+ "success"
1225
+ ]
1226
+ },
1227
+ "data": {
1228
+ "type": "array",
1229
+ "items": {
1230
+ "type": "object",
1231
+ "properties": {
1232
+ "id": {
1233
+ "oneOf": [
1234
+ {
1235
+ "type": "string"
1236
+ },
1237
+ {
1238
+ "type": "number"
1239
+ }
1240
+ ],
1241
+ "description": "Category ID"
1242
+ },
1243
+ "name": {
1244
+ "type": "string",
1245
+ "description": "Category name"
1246
+ },
1247
+ "level": {
1248
+ "type": "number",
1249
+ "description": "Category level in hierarchy"
1250
+ },
1251
+ "parentId": {
1252
+ "oneOf": [
1253
+ {
1254
+ "type": "string"
1255
+ },
1256
+ {
1257
+ "type": "number"
1258
+ }
1259
+ ],
1260
+ "description": "Parent category ID"
1261
+ },
1262
+ "isLeaf": {
1263
+ "type": "boolean",
1264
+ "description": "Whether this is a leaf category"
1265
+ },
1266
+ "fullPath": {
1267
+ "type": "string",
1268
+ "description": "Full category path"
1269
+ },
1270
+ "parentIds": {
1271
+ "type": "array",
1272
+ "items": {
1273
+ "oneOf": [
1274
+ {
1275
+ "type": "string"
1276
+ },
1277
+ {
1278
+ "type": "number"
1279
+ }
1280
+ ]
1281
+ },
1282
+ "description": "Array of parent category IDs"
1283
+ }
1284
+ },
1285
+ "required": [
1286
+ "id",
1287
+ "name",
1288
+ "level",
1289
+ "parentId",
1290
+ "isLeaf"
1291
+ ]
1292
+ }
1293
+ }
1294
+ },
1295
+ "required": [
1296
+ "status",
1297
+ "data"
1298
+ ]
1299
+ }
1300
+ }
1301
+ }
1302
+ },
1303
+ "400": {
1304
+ "description": "Invalid request parameters",
1305
+ "content": {
1306
+ "application/json": {
1307
+ "schema": {
1308
+ "type": "object",
1309
+ "properties": {
1310
+ "error": {
1311
+ "type": "string"
1312
+ },
1313
+ "code": {
1314
+ "type": "string"
1315
+ },
1316
+ "details": {
1317
+ "type": "array",
1318
+ "items": {}
1319
+ }
1320
+ },
1321
+ "required": [
1322
+ "error",
1323
+ "code"
1324
+ ]
1325
+ }
1326
+ }
1327
+ }
1328
+ },
1329
+ "401": {
1330
+ "description": "Unauthorized - Invalid or missing eBay token",
1331
+ "content": {
1332
+ "application/json": {
1333
+ "schema": {
1334
+ "type": "object",
1335
+ "properties": {
1336
+ "error": {
1337
+ "type": "string"
1338
+ },
1339
+ "code": {
1340
+ "type": "string"
1341
+ },
1342
+ "details": {
1343
+ "type": "array",
1344
+ "items": {}
1345
+ }
1346
+ },
1347
+ "required": [
1348
+ "error",
1349
+ "code"
1350
+ ]
1351
+ }
1352
+ }
1353
+ }
1354
+ },
1355
+ "403": {
1356
+ "description": "Forbidden",
1357
+ "content": {
1358
+ "application/json": {
1359
+ "schema": {
1360
+ "type": "object",
1361
+ "properties": {
1362
+ "error": {
1363
+ "type": "string"
1364
+ },
1365
+ "code": {
1366
+ "type": "string"
1367
+ },
1368
+ "details": {
1369
+ "type": "array",
1370
+ "items": {}
1371
+ }
1372
+ },
1373
+ "required": [
1374
+ "error",
1375
+ "code"
1376
+ ]
1377
+ }
1378
+ }
1379
+ }
1380
+ },
1381
+ "500": {
1382
+ "description": "Internal server error",
1383
+ "content": {
1384
+ "application/json": {
1385
+ "schema": {
1386
+ "type": "object",
1387
+ "properties": {
1388
+ "error": {
1389
+ "type": "string"
1390
+ },
1391
+ "code": {
1392
+ "type": "string"
1393
+ },
1394
+ "details": {
1395
+ "type": "array",
1396
+ "items": {}
1397
+ }
1398
+ },
1399
+ "required": [
1400
+ "error",
1401
+ "code"
1402
+ ]
1403
+ }
1404
+ }
1405
+ }
1406
+ }
1407
+ },
1408
+ "operationId": "get_api_ebay_categories_top_level_833ef4a3",
1409
+ "method": "get",
1410
+ "path": "/api/ebay/categories/top-level"
1411
+ },
1412
+ "API-get_api_ebay_categories_leaves_3ea8b601": {
1413
+ "tags": [
1414
+ "Categories"
1415
+ ],
1416
+ "summary": "Get leaf categories",
1417
+ "description": "Returns all leaf categories under the specified parent category",
1418
+ "security": [
1419
+ {
1420
+ "bearer": [
1421
+ "https://api.ebay.com/oauth/api_scope"
1422
+ ]
1423
+ }
1424
+ ],
1425
+ "parameters": [
1426
+ {
1427
+ "name": "categoryId",
1428
+ "in": "path",
1429
+ "required": true,
1430
+ "schema": {
1431
+ "type": "string",
1432
+ "description": "Parent category ID"
1433
+ },
1434
+ "description": "Parent category ID"
1435
+ },
1436
+ {
1437
+ "name": "userId",
1438
+ "in": "query",
1439
+ "required": true,
1440
+ "schema": {
1441
+ "type": "string",
1442
+ "description": "eBay user ID"
1443
+ },
1444
+ "description": "eBay user ID"
1445
+ },
1446
+ {
1447
+ "name": "siteId",
1448
+ "in": "query",
1449
+ "required": true,
1450
+ "schema": {
1451
+ "type": "string",
1452
+ "description": "eBay site ID (e.g., 'EBAY_US')"
1453
+ },
1454
+ "description": "eBay site ID (e.g., 'EBAY_US')"
1455
+ }
1456
+ ],
1457
+ "responses": {
1458
+ "200": {
1459
+ "description": "Successful response",
1460
+ "content": {
1461
+ "application/json": {
1462
+ "schema": {
1463
+ "type": "object",
1464
+ "properties": {
1465
+ "status": {
1466
+ "type": "string",
1467
+ "enum": [
1468
+ "success"
1469
+ ]
1470
+ },
1471
+ "data": {
1472
+ "type": "array",
1473
+ "items": {
1474
+ "type": "object",
1475
+ "properties": {
1476
+ "id": {
1477
+ "oneOf": [
1478
+ {
1479
+ "type": "string"
1480
+ },
1481
+ {
1482
+ "type": "number"
1483
+ }
1484
+ ],
1485
+ "description": "Category ID"
1486
+ },
1487
+ "name": {
1488
+ "type": "string",
1489
+ "description": "Category name"
1490
+ },
1491
+ "level": {
1492
+ "type": "number",
1493
+ "description": "Category level in hierarchy"
1494
+ },
1495
+ "parentId": {
1496
+ "oneOf": [
1497
+ {
1498
+ "type": "string"
1499
+ },
1500
+ {
1501
+ "type": "number"
1502
+ }
1503
+ ],
1504
+ "description": "Parent category ID"
1505
+ },
1506
+ "isLeaf": {
1507
+ "type": "boolean",
1508
+ "description": "Whether this is a leaf category"
1509
+ },
1510
+ "fullPath": {
1511
+ "type": "string",
1512
+ "description": "Full category path"
1513
+ },
1514
+ "parentIds": {
1515
+ "type": "array",
1516
+ "items": {
1517
+ "oneOf": [
1518
+ {
1519
+ "type": "string"
1520
+ },
1521
+ {
1522
+ "type": "number"
1523
+ }
1524
+ ]
1525
+ },
1526
+ "description": "Array of parent category IDs"
1527
+ }
1528
+ },
1529
+ "required": [
1530
+ "id",
1531
+ "name",
1532
+ "level",
1533
+ "parentId",
1534
+ "isLeaf"
1535
+ ]
1536
+ }
1537
+ }
1538
+ },
1539
+ "required": [
1540
+ "status",
1541
+ "data"
1542
+ ]
1543
+ }
1544
+ }
1545
+ }
1546
+ },
1547
+ "400": {
1548
+ "description": "Invalid request parameters",
1549
+ "content": {
1550
+ "application/json": {
1551
+ "schema": {
1552
+ "type": "object",
1553
+ "properties": {
1554
+ "error": {
1555
+ "type": "string"
1556
+ },
1557
+ "code": {
1558
+ "type": "string"
1559
+ },
1560
+ "details": {
1561
+ "type": "array",
1562
+ "items": {}
1563
+ }
1564
+ },
1565
+ "required": [
1566
+ "error",
1567
+ "code"
1568
+ ]
1569
+ }
1570
+ }
1571
+ }
1572
+ },
1573
+ "401": {
1574
+ "description": "Unauthorized - Invalid or missing eBay token",
1575
+ "content": {
1576
+ "application/json": {
1577
+ "schema": {
1578
+ "type": "object",
1579
+ "properties": {
1580
+ "error": {
1581
+ "type": "string"
1582
+ },
1583
+ "code": {
1584
+ "type": "string"
1585
+ },
1586
+ "details": {
1587
+ "type": "array",
1588
+ "items": {}
1589
+ }
1590
+ },
1591
+ "required": [
1592
+ "error",
1593
+ "code"
1594
+ ]
1595
+ }
1596
+ }
1597
+ }
1598
+ },
1599
+ "403": {
1600
+ "description": "Forbidden",
1601
+ "content": {
1602
+ "application/json": {
1603
+ "schema": {
1604
+ "type": "object",
1605
+ "properties": {
1606
+ "error": {
1607
+ "type": "string"
1608
+ },
1609
+ "code": {
1610
+ "type": "string"
1611
+ },
1612
+ "details": {
1613
+ "type": "array",
1614
+ "items": {}
1615
+ }
1616
+ },
1617
+ "required": [
1618
+ "error",
1619
+ "code"
1620
+ ]
1621
+ }
1622
+ }
1623
+ }
1624
+ },
1625
+ "500": {
1626
+ "description": "Internal server error",
1627
+ "content": {
1628
+ "application/json": {
1629
+ "schema": {
1630
+ "type": "object",
1631
+ "properties": {
1632
+ "error": {
1633
+ "type": "string"
1634
+ },
1635
+ "code": {
1636
+ "type": "string"
1637
+ },
1638
+ "details": {
1639
+ "type": "array",
1640
+ "items": {}
1641
+ }
1642
+ },
1643
+ "required": [
1644
+ "error",
1645
+ "code"
1646
+ ]
1647
+ }
1648
+ }
1649
+ }
1650
+ }
1651
+ },
1652
+ "operationId": "get_api_ebay_categories_leaves_3ea8b601",
1653
+ "method": "get",
1654
+ "path": "/api/ebay/categories/leaves/{categoryId}"
1655
+ },
1656
+ "API-get_api_ebay_categories_conditions_0196f1da": {
1657
+ "tags": [
1658
+ "Categories"
1659
+ ],
1660
+ "summary": "Get category condition policies",
1661
+ "description": "Returns the condition policies for a specific category",
1662
+ "security": [
1663
+ {
1664
+ "bearer": [
1665
+ "https://api.ebay.com/oauth/api_scope"
1666
+ ]
1667
+ }
1668
+ ],
1669
+ "parameters": [
1670
+ {
1671
+ "name": "categoryId",
1672
+ "in": "path",
1673
+ "required": true,
1674
+ "schema": {
1675
+ "type": "string",
1676
+ "description": "Category ID"
1677
+ },
1678
+ "description": "Category ID"
1679
+ },
1680
+ {
1681
+ "name": "userId",
1682
+ "in": "query",
1683
+ "required": true,
1684
+ "schema": {
1685
+ "type": "string",
1686
+ "description": "eBay user ID"
1687
+ },
1688
+ "description": "eBay user ID"
1689
+ },
1690
+ {
1691
+ "name": "marketplaceId",
1692
+ "in": "query",
1693
+ "required": true,
1694
+ "schema": {
1695
+ "type": "string",
1696
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
1697
+ },
1698
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
1699
+ }
1700
+ ],
1701
+ "responses": {
1702
+ "200": {
1703
+ "description": "Successful response",
1704
+ "content": {
1705
+ "application/json": {
1706
+ "schema": {
1707
+ "type": "object",
1708
+ "properties": {
1709
+ "status": {
1710
+ "type": "string",
1711
+ "enum": [
1712
+ "success"
1713
+ ]
1714
+ },
1715
+ "data": {
1716
+ "type": "object",
1717
+ "properties": {
1718
+ "categoryId": {
1719
+ "oneOf": [
1720
+ {
1721
+ "type": "string"
1722
+ },
1723
+ {
1724
+ "type": "number"
1725
+ }
1726
+ ],
1727
+ "description": "The category ID"
1728
+ },
1729
+ "conditionDescriptors": {
1730
+ "type": "array",
1731
+ "items": {
1732
+ "type": "object",
1733
+ "properties": {
1734
+ "id": {
1735
+ "type": "string",
1736
+ "description": "The condition ID"
1737
+ },
1738
+ "description": {
1739
+ "type": "string",
1740
+ "description": "Description of the condition"
1741
+ }
1742
+ },
1743
+ "required": [
1744
+ "id"
1745
+ ]
1746
+ }
1747
+ }
1748
+ },
1749
+ "required": [
1750
+ "categoryId",
1751
+ "conditionDescriptors"
1752
+ ]
1753
+ }
1754
+ },
1755
+ "required": [
1756
+ "status",
1757
+ "data"
1758
+ ]
1759
+ }
1760
+ }
1761
+ }
1762
+ },
1763
+ "400": {
1764
+ "description": "Invalid request parameters",
1765
+ "content": {
1766
+ "application/json": {
1767
+ "schema": {
1768
+ "type": "object",
1769
+ "properties": {
1770
+ "error": {
1771
+ "type": "string"
1772
+ },
1773
+ "code": {
1774
+ "type": "string"
1775
+ },
1776
+ "details": {
1777
+ "type": "array",
1778
+ "items": {}
1779
+ }
1780
+ },
1781
+ "required": [
1782
+ "error",
1783
+ "code"
1784
+ ]
1785
+ }
1786
+ }
1787
+ }
1788
+ },
1789
+ "401": {
1790
+ "description": "Unauthorized - Invalid or missing eBay token",
1791
+ "content": {
1792
+ "application/json": {
1793
+ "schema": {
1794
+ "type": "object",
1795
+ "properties": {
1796
+ "error": {
1797
+ "type": "string"
1798
+ },
1799
+ "code": {
1800
+ "type": "string"
1801
+ },
1802
+ "details": {
1803
+ "type": "array",
1804
+ "items": {}
1805
+ }
1806
+ },
1807
+ "required": [
1808
+ "error",
1809
+ "code"
1810
+ ]
1811
+ }
1812
+ }
1813
+ }
1814
+ },
1815
+ "403": {
1816
+ "description": "Forbidden",
1817
+ "content": {
1818
+ "application/json": {
1819
+ "schema": {
1820
+ "type": "object",
1821
+ "properties": {
1822
+ "error": {
1823
+ "type": "string"
1824
+ },
1825
+ "code": {
1826
+ "type": "string"
1827
+ },
1828
+ "details": {
1829
+ "type": "array",
1830
+ "items": {}
1831
+ }
1832
+ },
1833
+ "required": [
1834
+ "error",
1835
+ "code"
1836
+ ]
1837
+ }
1838
+ }
1839
+ }
1840
+ },
1841
+ "404": {
1842
+ "description": "No condition policies found for the category",
1843
+ "content": {
1844
+ "application/json": {
1845
+ "schema": {
1846
+ "type": "object",
1847
+ "properties": {
1848
+ "error": {
1849
+ "type": "string"
1850
+ },
1851
+ "code": {
1852
+ "type": "string"
1853
+ },
1854
+ "details": {
1855
+ "type": "array",
1856
+ "items": {}
1857
+ }
1858
+ },
1859
+ "required": [
1860
+ "error",
1861
+ "code"
1862
+ ]
1863
+ }
1864
+ }
1865
+ }
1866
+ },
1867
+ "500": {
1868
+ "description": "Internal server error",
1869
+ "content": {
1870
+ "application/json": {
1871
+ "schema": {
1872
+ "type": "object",
1873
+ "properties": {
1874
+ "error": {
1875
+ "type": "string"
1876
+ },
1877
+ "code": {
1878
+ "type": "string"
1879
+ },
1880
+ "details": {
1881
+ "type": "array",
1882
+ "items": {}
1883
+ }
1884
+ },
1885
+ "required": [
1886
+ "error",
1887
+ "code"
1888
+ ]
1889
+ }
1890
+ }
1891
+ }
1892
+ }
1893
+ },
1894
+ "operationId": "get_api_ebay_categories_conditions_0196f1da",
1895
+ "method": "get",
1896
+ "path": "/api/ebay/categories/conditions/{categoryId}"
1897
+ },
1898
+ "API-get_api_ebay_categories_aspects_59d62e7d": {
1899
+ "tags": [
1900
+ "Categories"
1901
+ ],
1902
+ "summary": "Get category aspects",
1903
+ "description": "Returns the required and optional item aspects for a specific category",
1904
+ "security": [
1905
+ {
1906
+ "bearer": [
1907
+ "https://api.ebay.com/oauth/api_scope"
1908
+ ]
1909
+ }
1910
+ ],
1911
+ "parameters": [
1912
+ {
1913
+ "name": "categoryId",
1914
+ "in": "path",
1915
+ "required": true,
1916
+ "schema": {
1917
+ "type": "string",
1918
+ "description": "Category ID"
1919
+ },
1920
+ "description": "Category ID"
1921
+ },
1922
+ {
1923
+ "name": "userId",
1924
+ "in": "query",
1925
+ "required": true,
1926
+ "schema": {
1927
+ "type": "string",
1928
+ "description": "eBay user ID"
1929
+ },
1930
+ "description": "eBay user ID"
1931
+ },
1932
+ {
1933
+ "name": "marketplaceId",
1934
+ "in": "query",
1935
+ "required": true,
1936
+ "schema": {
1937
+ "type": "string",
1938
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
1939
+ },
1940
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
1941
+ }
1942
+ ],
1943
+ "responses": {
1944
+ "200": {
1945
+ "description": "Successful response",
1946
+ "content": {
1947
+ "application/json": {
1948
+ "schema": {
1949
+ "type": "object",
1950
+ "properties": {
1951
+ "status": {
1952
+ "type": "string",
1953
+ "enum": [
1954
+ "success"
1955
+ ]
1956
+ },
1957
+ "data": {
1958
+ "type": "object",
1959
+ "properties": {
1960
+ "aspects": {
1961
+ "type": "array",
1962
+ "items": {
1963
+ "type": "object",
1964
+ "properties": {
1965
+ "localizedAspectName": {
1966
+ "type": "string"
1967
+ },
1968
+ "aspectConstraint": {
1969
+ "type": "object",
1970
+ "properties": {
1971
+ "aspectDataType": {
1972
+ "type": "string",
1973
+ "enum": [
1974
+ "DATE",
1975
+ "NUMBER",
1976
+ "STRING",
1977
+ "TEXT"
1978
+ ]
1979
+ },
1980
+ "aspectEnabledForVariations": {
1981
+ "type": "boolean"
1982
+ },
1983
+ "aspectFormat": {
1984
+ "type": "string"
1985
+ },
1986
+ "aspectMaxLength": {
1987
+ "type": "number"
1988
+ },
1989
+ "aspectMode": {
1990
+ "type": "string",
1991
+ "enum": [
1992
+ "FREE_TEXT",
1993
+ "SELECTION_ONLY"
1994
+ ]
1995
+ },
1996
+ "aspectRequired": {
1997
+ "type": "boolean"
1998
+ },
1999
+ "aspectUsage": {
2000
+ "type": "string",
2001
+ "enum": [
2002
+ "RECOMMENDED",
2003
+ "OPTIONAL"
2004
+ ]
2005
+ },
2006
+ "expectedRequiredByDate": {
2007
+ "type": "string"
2008
+ },
2009
+ "itemToAspectCardinality": {
2010
+ "type": "string",
2011
+ "enum": [
2012
+ "MULTI",
2013
+ "SINGLE"
2014
+ ]
2015
+ }
2016
+ },
2017
+ "required": [
2018
+ "aspectDataType",
2019
+ "aspectEnabledForVariations",
2020
+ "aspectMode",
2021
+ "aspectRequired",
2022
+ "aspectUsage",
2023
+ "itemToAspectCardinality"
2024
+ ]
2025
+ },
2026
+ "aspectValues": {
2027
+ "type": "array",
2028
+ "items": {
2029
+ "type": "string"
2030
+ }
2031
+ },
2032
+ "relevanceIndicator": {
2033
+ "type": "object",
2034
+ "properties": {
2035
+ "searchCount": {
2036
+ "type": "number"
2037
+ }
2038
+ },
2039
+ "required": [
2040
+ "searchCount"
2041
+ ]
2042
+ }
2043
+ },
2044
+ "required": [
2045
+ "localizedAspectName",
2046
+ "aspectConstraint"
2047
+ ]
2048
+ }
2049
+ }
2050
+ },
2051
+ "required": [
2052
+ "aspects"
2053
+ ]
2054
+ }
2055
+ },
2056
+ "required": [
2057
+ "status",
2058
+ "data"
2059
+ ]
2060
+ }
2061
+ }
2062
+ }
2063
+ },
2064
+ "400": {
2065
+ "description": "Invalid request parameters",
2066
+ "content": {
2067
+ "application/json": {
2068
+ "schema": {
2069
+ "type": "object",
2070
+ "properties": {
2071
+ "error": {
2072
+ "type": "string"
2073
+ },
2074
+ "code": {
2075
+ "type": "string"
2076
+ },
2077
+ "details": {
2078
+ "type": "array",
2079
+ "items": {}
2080
+ }
2081
+ },
2082
+ "required": [
2083
+ "error",
2084
+ "code"
2085
+ ]
2086
+ }
2087
+ }
2088
+ }
2089
+ },
2090
+ "401": {
2091
+ "description": "Unauthorized - Invalid or missing eBay token",
2092
+ "content": {
2093
+ "application/json": {
2094
+ "schema": {
2095
+ "type": "object",
2096
+ "properties": {
2097
+ "error": {
2098
+ "type": "string"
2099
+ },
2100
+ "code": {
2101
+ "type": "string"
2102
+ },
2103
+ "details": {
2104
+ "type": "array",
2105
+ "items": {}
2106
+ }
2107
+ },
2108
+ "required": [
2109
+ "error",
2110
+ "code"
2111
+ ]
2112
+ }
2113
+ }
2114
+ }
2115
+ },
2116
+ "403": {
2117
+ "description": "Forbidden",
2118
+ "content": {
2119
+ "application/json": {
2120
+ "schema": {
2121
+ "type": "object",
2122
+ "properties": {
2123
+ "error": {
2124
+ "type": "string"
2125
+ },
2126
+ "code": {
2127
+ "type": "string"
2128
+ },
2129
+ "details": {
2130
+ "type": "array",
2131
+ "items": {}
2132
+ }
2133
+ },
2134
+ "required": [
2135
+ "error",
2136
+ "code"
2137
+ ]
2138
+ }
2139
+ }
2140
+ }
2141
+ },
2142
+ "404": {
2143
+ "description": "No aspects found for the category",
2144
+ "content": {
2145
+ "application/json": {
2146
+ "schema": {
2147
+ "type": "object",
2148
+ "properties": {
2149
+ "error": {
2150
+ "type": "string"
2151
+ },
2152
+ "code": {
2153
+ "type": "string"
2154
+ },
2155
+ "details": {
2156
+ "type": "array",
2157
+ "items": {}
2158
+ }
2159
+ },
2160
+ "required": [
2161
+ "error",
2162
+ "code"
2163
+ ]
2164
+ }
2165
+ }
2166
+ }
2167
+ },
2168
+ "500": {
2169
+ "description": "Internal server error",
2170
+ "content": {
2171
+ "application/json": {
2172
+ "schema": {
2173
+ "type": "object",
2174
+ "properties": {
2175
+ "error": {
2176
+ "type": "string"
2177
+ },
2178
+ "code": {
2179
+ "type": "string"
2180
+ },
2181
+ "details": {
2182
+ "type": "array",
2183
+ "items": {}
2184
+ }
2185
+ },
2186
+ "required": [
2187
+ "error",
2188
+ "code"
2189
+ ]
2190
+ }
2191
+ }
2192
+ }
2193
+ }
2194
+ },
2195
+ "operationId": "get_api_ebay_categories_aspects_59d62e7d",
2196
+ "method": "get",
2197
+ "path": "/api/ebay/categories/{categoryId}/aspects"
2198
+ },
2199
+ "API-get_api_ebay_categories_listing_requirements_700b6d7f": {
2200
+ "tags": [
2201
+ "Categories"
2202
+ ],
2203
+ "summary": "Get category listing requirements",
2204
+ "description": "Returns both the required/optional item aspects and allowed conditions for a specific category",
2205
+ "security": [
2206
+ {
2207
+ "bearer": [
2208
+ "https://api.ebay.com/oauth/api_scope"
2209
+ ]
2210
+ }
2211
+ ],
2212
+ "parameters": [
2213
+ {
2214
+ "name": "categoryId",
2215
+ "in": "path",
2216
+ "required": true,
2217
+ "schema": {
2218
+ "type": "string",
2219
+ "description": "Category ID"
2220
+ },
2221
+ "description": "Category ID"
2222
+ },
2223
+ {
2224
+ "name": "userId",
2225
+ "in": "query",
2226
+ "required": true,
2227
+ "schema": {
2228
+ "type": "string",
2229
+ "description": "eBay user ID"
2230
+ },
2231
+ "description": "eBay user ID"
2232
+ },
2233
+ {
2234
+ "name": "marketplaceId",
2235
+ "in": "query",
2236
+ "required": true,
2237
+ "schema": {
2238
+ "type": "string",
2239
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
2240
+ },
2241
+ "description": "eBay marketplace ID (e.g., 'EBAY_US')"
2242
+ }
2243
+ ],
2244
+ "responses": {
2245
+ "200": {
2246
+ "description": "Successful response",
2247
+ "content": {
2248
+ "application/json": {
2249
+ "schema": {
2250
+ "type": "object",
2251
+ "properties": {
2252
+ "status": {
2253
+ "type": "string",
2254
+ "enum": [
2255
+ "success"
2256
+ ]
2257
+ },
2258
+ "data": {
2259
+ "type": "object",
2260
+ "properties": {
2261
+ "categoryId": {
2262
+ "oneOf": [
2263
+ {
2264
+ "type": "string"
2265
+ },
2266
+ {
2267
+ "type": "number"
2268
+ }
2269
+ ]
2270
+ },
2271
+ "aspects": {
2272
+ "type": "array",
2273
+ "items": {
2274
+ "type": "object",
2275
+ "properties": {
2276
+ "localizedAspectName": {
2277
+ "type": "string"
2278
+ },
2279
+ "aspectConstraint": {
2280
+ "type": "object",
2281
+ "properties": {
2282
+ "aspectDataType": {
2283
+ "type": "string",
2284
+ "enum": [
2285
+ "DATE",
2286
+ "NUMBER",
2287
+ "STRING",
2288
+ "TEXT"
2289
+ ]
2290
+ },
2291
+ "aspectEnabledForVariations": {
2292
+ "type": "boolean"
2293
+ },
2294
+ "aspectFormat": {
2295
+ "type": "string"
2296
+ },
2297
+ "aspectMaxLength": {
2298
+ "type": "number"
2299
+ },
2300
+ "aspectMode": {
2301
+ "type": "string",
2302
+ "enum": [
2303
+ "FREE_TEXT",
2304
+ "SELECTION_ONLY"
2305
+ ]
2306
+ },
2307
+ "aspectRequired": {
2308
+ "type": "boolean"
2309
+ },
2310
+ "aspectUsage": {
2311
+ "type": "string",
2312
+ "enum": [
2313
+ "RECOMMENDED",
2314
+ "OPTIONAL"
2315
+ ]
2316
+ },
2317
+ "expectedRequiredByDate": {
2318
+ "type": "string"
2319
+ },
2320
+ "itemToAspectCardinality": {
2321
+ "type": "string",
2322
+ "enum": [
2323
+ "MULTI",
2324
+ "SINGLE"
2325
+ ]
2326
+ }
2327
+ },
2328
+ "required": [
2329
+ "aspectDataType",
2330
+ "aspectEnabledForVariations",
2331
+ "aspectMode",
2332
+ "aspectRequired",
2333
+ "aspectUsage",
2334
+ "itemToAspectCardinality"
2335
+ ]
2336
+ },
2337
+ "aspectValues": {
2338
+ "type": "array",
2339
+ "items": {
2340
+ "type": "string"
2341
+ }
2342
+ },
2343
+ "relevanceIndicator": {
2344
+ "type": "object",
2345
+ "properties": {
2346
+ "searchCount": {
2347
+ "type": "number"
2348
+ }
2349
+ },
2350
+ "required": [
2351
+ "searchCount"
2352
+ ]
2353
+ }
2354
+ },
2355
+ "required": [
2356
+ "localizedAspectName",
2357
+ "aspectConstraint"
2358
+ ]
2359
+ }
2360
+ },
2361
+ "conditions": {
2362
+ "type": "array",
2363
+ "items": {
2364
+ "type": "object",
2365
+ "properties": {
2366
+ "id": {
2367
+ "type": "string"
2368
+ },
2369
+ "description": {
2370
+ "type": "string"
2371
+ }
2372
+ },
2373
+ "required": [
2374
+ "id"
2375
+ ]
2376
+ }
2377
+ }
2378
+ },
2379
+ "required": [
2380
+ "categoryId",
2381
+ "aspects",
2382
+ "conditions"
2383
+ ]
2384
+ }
2385
+ },
2386
+ "required": [
2387
+ "status",
2388
+ "data"
2389
+ ]
2390
+ }
2391
+ }
2392
+ }
2393
+ },
2394
+ "400": {
2395
+ "description": "Invalid request parameters",
2396
+ "content": {
2397
+ "application/json": {
2398
+ "schema": {
2399
+ "type": "object",
2400
+ "properties": {
2401
+ "error": {
2402
+ "type": "string"
2403
+ },
2404
+ "code": {
2405
+ "type": "string"
2406
+ },
2407
+ "details": {
2408
+ "type": "array",
2409
+ "items": {}
2410
+ }
2411
+ },
2412
+ "required": [
2413
+ "error",
2414
+ "code"
2415
+ ]
2416
+ }
2417
+ }
2418
+ }
2419
+ },
2420
+ "401": {
2421
+ "description": "Unauthorized - Invalid or missing eBay token",
2422
+ "content": {
2423
+ "application/json": {
2424
+ "schema": {
2425
+ "type": "object",
2426
+ "properties": {
2427
+ "error": {
2428
+ "type": "string"
2429
+ },
2430
+ "code": {
2431
+ "type": "string"
2432
+ },
2433
+ "details": {
2434
+ "type": "array",
2435
+ "items": {}
2436
+ }
2437
+ },
2438
+ "required": [
2439
+ "error",
2440
+ "code"
2441
+ ]
2442
+ }
2443
+ }
2444
+ }
2445
+ },
2446
+ "403": {
2447
+ "description": "Forbidden",
2448
+ "content": {
2449
+ "application/json": {
2450
+ "schema": {
2451
+ "type": "object",
2452
+ "properties": {
2453
+ "error": {
2454
+ "type": "string"
2455
+ },
2456
+ "code": {
2457
+ "type": "string"
2458
+ },
2459
+ "details": {
2460
+ "type": "array",
2461
+ "items": {}
2462
+ }
2463
+ },
2464
+ "required": [
2465
+ "error",
2466
+ "code"
2467
+ ]
2468
+ }
2469
+ }
2470
+ }
2471
+ },
2472
+ "404": {
2473
+ "description": "No aspects or conditions found for the category",
2474
+ "content": {
2475
+ "application/json": {
2476
+ "schema": {
2477
+ "type": "object",
2478
+ "properties": {
2479
+ "error": {
2480
+ "type": "string"
2481
+ },
2482
+ "code": {
2483
+ "type": "string"
2484
+ },
2485
+ "details": {
2486
+ "type": "array",
2487
+ "items": {}
2488
+ }
2489
+ },
2490
+ "required": [
2491
+ "error",
2492
+ "code"
2493
+ ]
2494
+ }
2495
+ }
2496
+ }
2497
+ },
2498
+ "500": {
2499
+ "description": "Internal server error",
2500
+ "content": {
2501
+ "application/json": {
2502
+ "schema": {
2503
+ "type": "object",
2504
+ "properties": {
2505
+ "error": {
2506
+ "type": "string"
2507
+ },
2508
+ "code": {
2509
+ "type": "string"
2510
+ },
2511
+ "details": {
2512
+ "type": "array",
2513
+ "items": {}
2514
+ }
2515
+ },
2516
+ "required": [
2517
+ "error",
2518
+ "code"
2519
+ ]
2520
+ }
2521
+ }
2522
+ }
2523
+ }
2524
+ },
2525
+ "operationId": "get_api_ebay_categories_listing_requirements_700b6d7f",
2526
+ "method": "get",
2527
+ "path": "/api/ebay/categories/{categoryId}/listing-requirements"
2528
+ },
2529
+ "API-post_api_ebay_listings_auction_fe15420c": {
2530
+ "tags": [
2531
+ "Listings"
2532
+ ],
2533
+ "summary": "Create a new auction listing",
2534
+ "description": "Creates a new auction listing on eBay with the specified details",
2535
+ "security": [
2536
+ {
2537
+ "bearer": [
2538
+ "https://api.ebay.com/oauth/api_scope/sell.inventory"
2539
+ ]
2540
+ }
2541
+ ],
2542
+ "parameters": [
2543
+ {
2544
+ "name": "userId",
2545
+ "in": "query",
2546
+ "required": true,
2547
+ "schema": {
2548
+ "type": "string",
2549
+ "description": "eBay user ID"
2550
+ },
2551
+ "description": "eBay user ID"
2552
+ }
2553
+ ],
2554
+ "requestBody": {
2555
+ "required": true,
2556
+ "content": {
2557
+ "application/json": {
2558
+ "schema": {
2559
+ "type": "object",
2560
+ "properties": {
2561
+ "title": {
2562
+ "type": "string",
2563
+ "minLength": 1,
2564
+ "maxLength": 80,
2565
+ "description": "Listing title"
2566
+ },
2567
+ "description": {
2568
+ "type": "string",
2569
+ "minLength": 1,
2570
+ "description": "Listing description"
2571
+ },
2572
+ "categoryId": {
2573
+ "type": "string",
2574
+ "description": "eBay category ID"
2575
+ },
2576
+ "conditionId": {
2577
+ "type": "number",
2578
+ "description": "Item condition ID"
2579
+ },
2580
+ "startPrice": {
2581
+ "type": "number",
2582
+ "exclusiveMinimum": 0,
2583
+ "description": "Starting price"
2584
+ },
2585
+ "buyItNowPrice": {
2586
+ "type": "number",
2587
+ "exclusiveMinimum": 0,
2588
+ "description": "Buy it now price"
2589
+ },
2590
+ "listingDuration": {
2591
+ "default": "Days_7",
2592
+ "type": "string",
2593
+ "description": "Duration of the listing"
2594
+ },
2595
+ "shippingCost": {
2596
+ "type": "number",
2597
+ "minimum": 0,
2598
+ "description": "Shipping cost"
2599
+ },
2600
+ "postalCode": {
2601
+ "type": "string",
2602
+ "description": "Postal code for shipping"
2603
+ },
2604
+ "dispatchTimeMax": {
2605
+ "type": "integer",
2606
+ "exclusiveMinimum": 0,
2607
+ "description": "Maximum dispatch time in days"
2608
+ },
2609
+ "images": {
2610
+ "description": "Images for the listing",
2611
+ "type": "object",
2612
+ "properties": {
2613
+ "base64": {
2614
+ "type": "array",
2615
+ "items": {
2616
+ "type": "string"
2617
+ },
2618
+ "description": "Array of base64 encoded images"
2619
+ },
2620
+ "urls": {
2621
+ "type": "array",
2622
+ "items": {
2623
+ "type": "string",
2624
+ "format": "uri"
2625
+ },
2626
+ "description": "Array of image URLs"
2627
+ }
2628
+ }
2629
+ }
2630
+ },
2631
+ "required": [
2632
+ "title",
2633
+ "description",
2634
+ "categoryId",
2635
+ "startPrice",
2636
+ "shippingCost",
2637
+ "postalCode",
2638
+ "dispatchTimeMax",
2639
+ "images"
2640
+ ]
2641
+ }
2642
+ }
2643
+ }
2644
+ },
2645
+ "responses": {
2646
+ "200": {
2647
+ "description": "Successful response",
2648
+ "content": {
2649
+ "application/json": {
2650
+ "schema": {
2651
+ "discriminator": {
2652
+ "propertyName": "status"
2653
+ },
2654
+ "oneOf": [
2655
+ {
2656
+ "type": "object",
2657
+ "properties": {
2658
+ "status": {
2659
+ "type": "string",
2660
+ "enum": [
2661
+ "success"
2662
+ ]
2663
+ },
2664
+ "data": {
2665
+ "type": "object",
2666
+ "properties": {
2667
+ "itemId": {
2668
+ "type": "string",
2669
+ "description": "eBay item ID"
2670
+ },
2671
+ "title": {
2672
+ "type": "string",
2673
+ "description": "Listing title"
2674
+ },
2675
+ "startTime": {
2676
+ "type": "string",
2677
+ "description": "Listing start time"
2678
+ },
2679
+ "endTime": {
2680
+ "type": "string",
2681
+ "description": "Listing end time"
2682
+ }
2683
+ },
2684
+ "required": [
2685
+ "itemId",
2686
+ "title",
2687
+ "startTime",
2688
+ "endTime"
2689
+ ]
2690
+ }
2691
+ },
2692
+ "required": [
2693
+ "status",
2694
+ "data"
2695
+ ]
2696
+ },
2697
+ {
2698
+ "type": "object",
2699
+ "properties": {
2700
+ "status": {
2701
+ "type": "string",
2702
+ "enum": [
2703
+ "error"
2704
+ ]
2705
+ },
2706
+ "message": {
2707
+ "type": "string"
2708
+ },
2709
+ "errorType": {
2710
+ "type": "string",
2711
+ "enum": [
2712
+ "VALIDATION_ERROR",
2713
+ "BUSINESS_POLICIES_ERROR",
2714
+ "EBAY_API_ERROR",
2715
+ "AUTH_ERROR",
2716
+ "INTERNAL_ERROR"
2717
+ ]
2718
+ },
2719
+ "errors": {
2720
+ "type": "array",
2721
+ "items": {}
2722
+ }
2723
+ },
2724
+ "required": [
2725
+ "status",
2726
+ "message",
2727
+ "errorType"
2728
+ ]
2729
+ }
2730
+ ]
2731
+ }
2732
+ }
2733
+ }
2734
+ },
2735
+ "400": {
2736
+ "description": "Invalid request parameters or eBay API validation error",
2737
+ "content": {
2738
+ "application/json": {
2739
+ "schema": {
2740
+ "type": "object",
2741
+ "properties": {
2742
+ "status": {
2743
+ "type": "string",
2744
+ "enum": [
2745
+ "error"
2746
+ ]
2747
+ },
2748
+ "message": {
2749
+ "type": "string"
2750
+ },
2751
+ "errorType": {
2752
+ "type": "string",
2753
+ "enum": [
2754
+ "VALIDATION_ERROR",
2755
+ "BUSINESS_POLICIES_ERROR",
2756
+ "EBAY_API_ERROR",
2757
+ "AUTH_ERROR",
2758
+ "INTERNAL_ERROR"
2759
+ ]
2760
+ },
2761
+ "errors": {
2762
+ "type": "array",
2763
+ "items": {}
2764
+ }
2765
+ },
2766
+ "required": [
2767
+ "status",
2768
+ "message",
2769
+ "errorType"
2770
+ ]
2771
+ }
2772
+ }
2773
+ }
2774
+ },
2775
+ "401": {
2776
+ "description": "Unauthorized - Invalid or missing eBay token",
2777
+ "content": {
2778
+ "application/json": {
2779
+ "schema": {
2780
+ "type": "object",
2781
+ "properties": {
2782
+ "error": {
2783
+ "type": "string"
2784
+ },
2785
+ "code": {
2786
+ "type": "string"
2787
+ },
2788
+ "details": {
2789
+ "type": "array",
2790
+ "items": {}
2791
+ }
2792
+ },
2793
+ "required": [
2794
+ "error",
2795
+ "code"
2796
+ ]
2797
+ }
2798
+ }
2799
+ }
2800
+ },
2801
+ "403": {
2802
+ "description": "Forbidden - Insufficient permissions or business policy error",
2803
+ "content": {
2804
+ "application/json": {
2805
+ "schema": {
2806
+ "type": "object",
2807
+ "properties": {
2808
+ "status": {
2809
+ "type": "string",
2810
+ "enum": [
2811
+ "error"
2812
+ ]
2813
+ },
2814
+ "message": {
2815
+ "type": "string"
2816
+ },
2817
+ "errorType": {
2818
+ "type": "string",
2819
+ "enum": [
2820
+ "VALIDATION_ERROR",
2821
+ "BUSINESS_POLICIES_ERROR",
2822
+ "EBAY_API_ERROR",
2823
+ "AUTH_ERROR",
2824
+ "INTERNAL_ERROR"
2825
+ ]
2826
+ },
2827
+ "errors": {
2828
+ "type": "array",
2829
+ "items": {}
2830
+ }
2831
+ },
2832
+ "required": [
2833
+ "status",
2834
+ "message",
2835
+ "errorType"
2836
+ ]
2837
+ }
2838
+ }
2839
+ }
2840
+ },
2841
+ "500": {
2842
+ "description": "Internal server error",
2843
+ "content": {
2844
+ "application/json": {
2845
+ "schema": {
2846
+ "type": "object",
2847
+ "properties": {
2848
+ "status": {
2849
+ "type": "string",
2850
+ "enum": [
2851
+ "error"
2852
+ ]
2853
+ },
2854
+ "message": {
2855
+ "type": "string"
2856
+ },
2857
+ "errorType": {
2858
+ "type": "string",
2859
+ "enum": [
2860
+ "VALIDATION_ERROR",
2861
+ "BUSINESS_POLICIES_ERROR",
2862
+ "EBAY_API_ERROR",
2863
+ "AUTH_ERROR",
2864
+ "INTERNAL_ERROR"
2865
+ ]
2866
+ },
2867
+ "errors": {
2868
+ "type": "array",
2869
+ "items": {}
2870
+ }
2871
+ },
2872
+ "required": [
2873
+ "status",
2874
+ "message",
2875
+ "errorType"
2876
+ ]
2877
+ }
2878
+ }
2879
+ }
2880
+ }
2881
+ },
2882
+ "operationId": "post_api_ebay_listings_auction_fe15420c",
2883
+ "x-openai-isConsequential": false,
2884
+ "method": "post",
2885
+ "path": "/api/ebay/listings/auction"
2886
+ },
2887
+ "API-post_api_listings_advanced_1cdf2764": {
2888
+ "tags": [
2889
+ "Listings"
2890
+ ],
2891
+ "summary": "Create an advanced listing with full eBay Trading API support",
2892
+ "description": "Create a new eBay listing with advanced options including shipping, returns, and condition details",
2893
+ "parameters": [
2894
+ {
2895
+ "name": "site",
2896
+ "in": "query",
2897
+ "required": true,
2898
+ "schema": {
2899
+ "type": "string",
2900
+ "description": "The eBay site ID to list on"
2901
+ },
2902
+ "description": "The eBay site ID to list on"
2903
+ },
2904
+ {
2905
+ "name": "userId",
2906
+ "in": "query",
2907
+ "required": true,
2908
+ "schema": {
2909
+ "type": "string",
2910
+ "description": "The eBay user ID to authenticate as"
2911
+ },
2912
+ "description": "The eBay user ID to authenticate as"
2913
+ }
2914
+ ],
2915
+ "requestBody": {
2916
+ "required": true,
2917
+ "content": {
2918
+ "application/json": {
2919
+ "schema": {
2920
+ "type": "object",
2921
+ "properties": {
2922
+ "item": {
2923
+ "type": "object",
2924
+ "properties": {
2925
+ "title": {
2926
+ "type": "string"
2927
+ },
2928
+ "primaryCategory": {
2929
+ "type": "object",
2930
+ "properties": {
2931
+ "categoryId": {
2932
+ "type": "string"
2933
+ },
2934
+ "categoryName": {
2935
+ "type": "string"
2936
+ }
2937
+ },
2938
+ "required": [
2939
+ "categoryId"
2940
+ ]
2941
+ },
2942
+ "quantity": {
2943
+ "type": "integer"
2944
+ },
2945
+ "itemSpecifics": {
2946
+ "type": "object",
2947
+ "additionalProperties": {
2948
+ "oneOf": [
2949
+ {
2950
+ "type": "string"
2951
+ },
2952
+ {
2953
+ "type": "array",
2954
+ "items": {
2955
+ "type": "string"
2956
+ }
2957
+ }
2958
+ ]
2959
+ }
2960
+ },
2961
+ "startPrice": {
2962
+ "type": "object",
2963
+ "properties": {
2964
+ "value": {
2965
+ "type": "number"
2966
+ },
2967
+ "currencyId": {
2968
+ "type": "string"
2969
+ }
2970
+ },
2971
+ "required": [
2972
+ "value",
2973
+ "currencyId"
2974
+ ]
2975
+ },
2976
+ "description": {
2977
+ "type": "string"
2978
+ },
2979
+ "listingDuration": {
2980
+ "type": "string"
2981
+ },
2982
+ "listingType": {
2983
+ "type": "string"
2984
+ },
2985
+ "location": {
2986
+ "type": "string"
2987
+ },
2988
+ "country": {
2989
+ "type": "string"
2990
+ },
2991
+ "currency": {
2992
+ "type": "string"
2993
+ },
2994
+ "paymentMethods": {
2995
+ "type": "array",
2996
+ "items": {
2997
+ "type": "string"
2998
+ }
2999
+ },
3000
+ "dispatchTimeMax": {
3001
+ "default": 3,
3002
+ "type": "integer"
3003
+ },
3004
+ "pictureDetails": {
3005
+ "type": "object",
3006
+ "properties": {
3007
+ "galleryType": {
3008
+ "type": "string"
3009
+ },
3010
+ "pictureUrl": {
3011
+ "type": "array",
3012
+ "items": {
3013
+ "type": "string",
3014
+ "format": "uri"
3015
+ }
3016
+ }
3017
+ },
3018
+ "required": [
3019
+ "galleryType"
3020
+ ]
3021
+ },
3022
+ "returnPolicy": {
3023
+ "type": "object",
3024
+ "properties": {
3025
+ "returnsAcceptedOption": {
3026
+ "type": "string",
3027
+ "enum": [
3028
+ "ReturnsAccepted",
3029
+ "ReturnsNotAccepted"
3030
+ ]
3031
+ },
3032
+ "returnsWithinOption": {
3033
+ "type": "string"
3034
+ },
3035
+ "description": {
3036
+ "type": "string"
3037
+ }
3038
+ },
3039
+ "required": [
3040
+ "returnsAcceptedOption",
3041
+ "description"
3042
+ ]
3043
+ },
3044
+ "shippingDetails": {
3045
+ "type": "object",
3046
+ "properties": {
3047
+ "shippingType": {
3048
+ "type": "string"
3049
+ },
3050
+ "shippingServiceOptions": {
3051
+ "type": "array",
3052
+ "items": {
3053
+ "type": "object",
3054
+ "properties": {
3055
+ "shippingService": {
3056
+ "type": "string"
3057
+ },
3058
+ "shippingServiceCost": {
3059
+ "type": "object",
3060
+ "properties": {
3061
+ "value": {
3062
+ "type": "number"
3063
+ },
3064
+ "currencyId": {
3065
+ "type": "string"
3066
+ }
3067
+ },
3068
+ "required": [
3069
+ "value",
3070
+ "currencyId"
3071
+ ]
3072
+ },
3073
+ "freeShipping": {
3074
+ "type": "boolean"
3075
+ }
3076
+ },
3077
+ "required": [
3078
+ "shippingService"
3079
+ ]
3080
+ }
3081
+ }
3082
+ },
3083
+ "required": [
3084
+ "shippingType",
3085
+ "shippingServiceOptions"
3086
+ ]
3087
+ },
3088
+ "conditionId": {
3089
+ "type": "integer"
3090
+ },
3091
+ "conditionDescription": {
3092
+ "type": "string"
3093
+ }
3094
+ },
3095
+ "required": [
3096
+ "title",
3097
+ "primaryCategory",
3098
+ "quantity",
3099
+ "startPrice",
3100
+ "location"
3101
+ ]
3102
+ },
3103
+ "errorLanguage": {
3104
+ "type": "string"
3105
+ },
3106
+ "warningLevel": {
3107
+ "type": "string"
3108
+ }
3109
+ },
3110
+ "required": [
3111
+ "item"
3112
+ ]
3113
+ }
3114
+ }
3115
+ }
3116
+ },
3117
+ "responses": {
3118
+ "200": {
3119
+ "description": "Successful response",
3120
+ "content": {
3121
+ "application/json": {
3122
+ "schema": {
3123
+ "type": "object",
3124
+ "properties": {
3125
+ "itemId": {
3126
+ "type": "string"
3127
+ },
3128
+ "startTime": {
3129
+ "type": "string"
3130
+ },
3131
+ "endTime": {
3132
+ "type": "string"
3133
+ },
3134
+ "fees": {
3135
+ "type": "array",
3136
+ "items": {
3137
+ "type": "object",
3138
+ "properties": {
3139
+ "name": {
3140
+ "type": "string"
3141
+ },
3142
+ "fee": {
3143
+ "type": "object",
3144
+ "properties": {
3145
+ "value": {
3146
+ "type": "number"
3147
+ },
3148
+ "currencyId": {
3149
+ "type": "string"
3150
+ }
3151
+ },
3152
+ "required": [
3153
+ "value",
3154
+ "currencyId"
3155
+ ]
3156
+ }
3157
+ },
3158
+ "required": [
3159
+ "name",
3160
+ "fee"
3161
+ ]
3162
+ }
3163
+ },
3164
+ "category": {
3165
+ "type": "object",
3166
+ "properties": {
3167
+ "categoryId": {
3168
+ "type": "string"
3169
+ },
3170
+ "categoryName": {
3171
+ "type": "string"
3172
+ }
3173
+ },
3174
+ "required": [
3175
+ "categoryId"
3176
+ ]
3177
+ },
3178
+ "message": {
3179
+ "type": "string"
3180
+ }
3181
+ },
3182
+ "required": [
3183
+ "itemId",
3184
+ "startTime",
3185
+ "endTime",
3186
+ "fees",
3187
+ "category",
3188
+ "message"
3189
+ ]
3190
+ }
3191
+ }
3192
+ }
3193
+ },
3194
+ "400": {
3195
+ "description": "Invalid request parameters or eBay API validation error",
3196
+ "content": {
3197
+ "application/json": {
3198
+ "schema": {
3199
+ "type": "object",
3200
+ "properties": {
3201
+ "status": {
3202
+ "type": "string",
3203
+ "enum": [
3204
+ "error"
3205
+ ]
3206
+ },
3207
+ "message": {
3208
+ "type": "string"
3209
+ },
3210
+ "details": {
3211
+ "type": "string"
3212
+ },
3213
+ "errorType": {
3214
+ "type": "string",
3215
+ "enum": [
3216
+ "VALIDATION_ERROR",
3217
+ "BUSINESS_POLICIES_ERROR",
3218
+ "EBAY_API_ERROR",
3219
+ "AUTH_ERROR",
3220
+ "INTERNAL_ERROR"
3221
+ ]
3222
+ },
3223
+ "errors": {
3224
+ "type": "array",
3225
+ "items": {
3226
+ "type": "object",
3227
+ "properties": {
3228
+ "code": {
3229
+ "oneOf": [
3230
+ {
3231
+ "type": "string"
3232
+ },
3233
+ {
3234
+ "type": "number"
3235
+ }
3236
+ ]
3237
+ },
3238
+ "message": {
3239
+ "type": "string"
3240
+ },
3241
+ "severity": {
3242
+ "type": "string"
3243
+ },
3244
+ "classification": {
3245
+ "type": "string"
3246
+ }
3247
+ },
3248
+ "required": [
3249
+ "code",
3250
+ "message"
3251
+ ]
3252
+ }
3253
+ }
3254
+ },
3255
+ "required": [
3256
+ "status",
3257
+ "message",
3258
+ "errorType"
3259
+ ]
3260
+ }
3261
+ }
3262
+ }
3263
+ },
3264
+ "401": {
3265
+ "description": "Unauthorized - Invalid or missing eBay token",
3266
+ "content": {
3267
+ "application/json": {
3268
+ "schema": {
3269
+ "type": "object",
3270
+ "properties": {
3271
+ "status": {
3272
+ "type": "string",
3273
+ "enum": [
3274
+ "error"
3275
+ ]
3276
+ },
3277
+ "message": {
3278
+ "type": "string"
3279
+ },
3280
+ "details": {
3281
+ "type": "string"
3282
+ },
3283
+ "errorType": {
3284
+ "type": "string",
3285
+ "enum": [
3286
+ "VALIDATION_ERROR",
3287
+ "BUSINESS_POLICIES_ERROR",
3288
+ "EBAY_API_ERROR",
3289
+ "AUTH_ERROR",
3290
+ "INTERNAL_ERROR"
3291
+ ]
3292
+ },
3293
+ "errors": {
3294
+ "type": "array",
3295
+ "items": {
3296
+ "type": "object",
3297
+ "properties": {
3298
+ "code": {
3299
+ "oneOf": [
3300
+ {
3301
+ "type": "string"
3302
+ },
3303
+ {
3304
+ "type": "number"
3305
+ }
3306
+ ]
3307
+ },
3308
+ "message": {
3309
+ "type": "string"
3310
+ },
3311
+ "severity": {
3312
+ "type": "string"
3313
+ },
3314
+ "classification": {
3315
+ "type": "string"
3316
+ }
3317
+ },
3318
+ "required": [
3319
+ "code",
3320
+ "message"
3321
+ ]
3322
+ }
3323
+ }
3324
+ },
3325
+ "required": [
3326
+ "status",
3327
+ "message",
3328
+ "errorType"
3329
+ ]
3330
+ }
3331
+ }
3332
+ }
3333
+ },
3334
+ "403": {
3335
+ "description": "Forbidden - Insufficient permissions or business policy error",
3336
+ "content": {
3337
+ "application/json": {
3338
+ "schema": {
3339
+ "type": "object",
3340
+ "properties": {
3341
+ "status": {
3342
+ "type": "string",
3343
+ "enum": [
3344
+ "error"
3345
+ ]
3346
+ },
3347
+ "message": {
3348
+ "type": "string"
3349
+ },
3350
+ "details": {
3351
+ "type": "string"
3352
+ },
3353
+ "errorType": {
3354
+ "type": "string",
3355
+ "enum": [
3356
+ "VALIDATION_ERROR",
3357
+ "BUSINESS_POLICIES_ERROR",
3358
+ "EBAY_API_ERROR",
3359
+ "AUTH_ERROR",
3360
+ "INTERNAL_ERROR"
3361
+ ]
3362
+ },
3363
+ "errors": {
3364
+ "type": "array",
3365
+ "items": {
3366
+ "type": "object",
3367
+ "properties": {
3368
+ "code": {
3369
+ "oneOf": [
3370
+ {
3371
+ "type": "string"
3372
+ },
3373
+ {
3374
+ "type": "number"
3375
+ }
3376
+ ]
3377
+ },
3378
+ "message": {
3379
+ "type": "string"
3380
+ },
3381
+ "severity": {
3382
+ "type": "string"
3383
+ },
3384
+ "classification": {
3385
+ "type": "string"
3386
+ }
3387
+ },
3388
+ "required": [
3389
+ "code",
3390
+ "message"
3391
+ ]
3392
+ }
3393
+ }
3394
+ },
3395
+ "required": [
3396
+ "status",
3397
+ "message",
3398
+ "errorType"
3399
+ ]
3400
+ }
3401
+ }
3402
+ }
3403
+ },
3404
+ "500": {
3405
+ "description": "Internal server error",
3406
+ "content": {
3407
+ "application/json": {
3408
+ "schema": {
3409
+ "type": "object",
3410
+ "properties": {
3411
+ "status": {
3412
+ "type": "string",
3413
+ "enum": [
3414
+ "error"
3415
+ ]
3416
+ },
3417
+ "message": {
3418
+ "type": "string"
3419
+ },
3420
+ "details": {
3421
+ "type": "string"
3422
+ },
3423
+ "errorType": {
3424
+ "type": "string",
3425
+ "enum": [
3426
+ "VALIDATION_ERROR",
3427
+ "BUSINESS_POLICIES_ERROR",
3428
+ "EBAY_API_ERROR",
3429
+ "AUTH_ERROR",
3430
+ "INTERNAL_ERROR"
3431
+ ]
3432
+ },
3433
+ "errors": {
3434
+ "type": "array",
3435
+ "items": {
3436
+ "type": "object",
3437
+ "properties": {
3438
+ "code": {
3439
+ "oneOf": [
3440
+ {
3441
+ "type": "string"
3442
+ },
3443
+ {
3444
+ "type": "number"
3445
+ }
3446
+ ]
3447
+ },
3448
+ "message": {
3449
+ "type": "string"
3450
+ },
3451
+ "severity": {
3452
+ "type": "string"
3453
+ },
3454
+ "classification": {
3455
+ "type": "string"
3456
+ }
3457
+ },
3458
+ "required": [
3459
+ "code",
3460
+ "message"
3461
+ ]
3462
+ }
3463
+ }
3464
+ },
3465
+ "required": [
3466
+ "status",
3467
+ "message",
3468
+ "errorType"
3469
+ ]
3470
+ }
3471
+ }
3472
+ }
3473
+ }
3474
+ },
3475
+ "operationId": "post_api_listings_advanced_1cdf2764",
3476
+ "x-openai-isConsequential": false,
3477
+ "method": "post",
3478
+ "path": "/api/listings/advanced"
3479
+ },
3480
+ "API-post_api_images_upload_830cd0c4": {
3481
+ "tags": [
3482
+ "Images"
3483
+ ],
3484
+ "summary": "Upload multiple images",
3485
+ "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.",
3486
+ "parameters": [],
3487
+ "requestBody": {
3488
+ "required": true,
3489
+ "content": {
3490
+ "multipart/form-data": {
3491
+ "schema": {
3492
+ "type": "object",
3493
+ "properties": {
3494
+ "images": {
3495
+ "type": "array",
3496
+ "items": {
3497
+ "type": "string",
3498
+ "format": "binary"
3499
+ },
3500
+ "description": "Image files to upload. Supports JPEG, PNG, GIF, and WebP formats. Maximum 12 files, each up to 5MB."
3501
+ }
3502
+ },
3503
+ "required": [
3504
+ "images"
3505
+ ]
3506
+ }
3507
+ }
3508
+ }
3509
+ },
3510
+ "responses": {
3511
+ "200": {
3512
+ "description": "Successful response",
3513
+ "content": {
3514
+ "application/json": {
3515
+ "schema": {
3516
+ "discriminator": {
3517
+ "propertyName": "status"
3518
+ },
3519
+ "oneOf": [
3520
+ {
3521
+ "type": "object",
3522
+ "properties": {
3523
+ "status": {
3524
+ "type": "string",
3525
+ "enum": [
3526
+ "success"
3527
+ ]
3528
+ },
3529
+ "data": {
3530
+ "type": "object",
3531
+ "properties": {
3532
+ "urls": {
3533
+ "type": "array",
3534
+ "items": {
3535
+ "type": "string",
3536
+ "format": "uri"
3537
+ },
3538
+ "description": "URLs of the uploaded images"
3539
+ }
3540
+ },
3541
+ "required": [
3542
+ "urls"
3543
+ ]
3544
+ }
3545
+ },
3546
+ "required": [
3547
+ "status",
3548
+ "data"
3549
+ ]
3550
+ },
3551
+ {
3552
+ "type": "object",
3553
+ "properties": {
3554
+ "status": {
3555
+ "type": "string",
3556
+ "enum": [
3557
+ "error"
3558
+ ]
3559
+ },
3560
+ "message": {
3561
+ "type": "string"
3562
+ },
3563
+ "errorType": {
3564
+ "type": "string",
3565
+ "enum": [
3566
+ "VALIDATION_ERROR",
3567
+ "UPLOAD_ERROR",
3568
+ "INTERNAL_ERROR"
3569
+ ]
3570
+ }
3571
+ },
3572
+ "required": [
3573
+ "status",
3574
+ "message",
3575
+ "errorType"
3576
+ ]
3577
+ }
3578
+ ]
3579
+ }
3580
+ }
3581
+ }
3582
+ },
3583
+ "400": {
3584
+ "description": "Invalid request parameters or file validation error",
3585
+ "content": {
3586
+ "application/json": {
3587
+ "schema": {
3588
+ "type": "object",
3589
+ "properties": {
3590
+ "status": {
3591
+ "type": "string",
3592
+ "enum": [
3593
+ "error"
3594
+ ]
3595
+ },
3596
+ "message": {
3597
+ "type": "string"
3598
+ },
3599
+ "errorType": {
3600
+ "type": "string",
3601
+ "enum": [
3602
+ "VALIDATION_ERROR",
3603
+ "UPLOAD_ERROR",
3604
+ "INTERNAL_ERROR"
3605
+ ]
3606
+ }
3607
+ },
3608
+ "required": [
3609
+ "status",
3610
+ "message",
3611
+ "errorType"
3612
+ ]
3613
+ }
3614
+ }
3615
+ }
3616
+ },
3617
+ "401": {
3618
+ "description": "Unauthorized",
3619
+ "content": {
3620
+ "application/json": {
3621
+ "schema": {
3622
+ "type": "object",
3623
+ "properties": {
3624
+ "error": {
3625
+ "type": "string"
3626
+ },
3627
+ "code": {
3628
+ "type": "string"
3629
+ },
3630
+ "details": {
3631
+ "type": "array",
3632
+ "items": {}
3633
+ }
3634
+ },
3635
+ "required": [
3636
+ "error",
3637
+ "code"
3638
+ ]
3639
+ }
3640
+ }
3641
+ }
3642
+ },
3643
+ "403": {
3644
+ "description": "Forbidden",
3645
+ "content": {
3646
+ "application/json": {
3647
+ "schema": {
3648
+ "type": "object",
3649
+ "properties": {
3650
+ "error": {
3651
+ "type": "string"
3652
+ },
3653
+ "code": {
3654
+ "type": "string"
3655
+ },
3656
+ "details": {
3657
+ "type": "array",
3658
+ "items": {}
3659
+ }
3660
+ },
3661
+ "required": [
3662
+ "error",
3663
+ "code"
3664
+ ]
3665
+ }
3666
+ }
3667
+ }
3668
+ },
3669
+ "500": {
3670
+ "description": "Internal server error",
3671
+ "content": {
3672
+ "application/json": {
3673
+ "schema": {
3674
+ "type": "object",
3675
+ "properties": {
3676
+ "status": {
3677
+ "type": "string",
3678
+ "enum": [
3679
+ "error"
3680
+ ]
3681
+ },
3682
+ "message": {
3683
+ "type": "string"
3684
+ },
3685
+ "errorType": {
3686
+ "type": "string",
3687
+ "enum": [
3688
+ "VALIDATION_ERROR",
3689
+ "UPLOAD_ERROR",
3690
+ "INTERNAL_ERROR"
3691
+ ]
3692
+ }
3693
+ },
3694
+ "required": [
3695
+ "status",
3696
+ "message",
3697
+ "errorType"
3698
+ ]
3699
+ }
3700
+ }
3701
+ }
3702
+ }
3703
+ },
3704
+ "operationId": "post_api_images_upload_830cd0c4",
3705
+ "x-openai-isConsequential": false,
3706
+ "method": "post",
3707
+ "path": "/api/images/upload"
3708
+ }
3709
+ }
3710
+ }