From 82004ad18377a5e7ece83eb887b8d127edcf7e7f Mon Sep 17 00:00:00 2001 From: olivermrbl Date: Mon, 27 Jan 2025 09:20:38 +0000 Subject: [PATCH 1/2] chore(docs): Generated API Reference (automated) --- ...tchCreateInventoryItemsLocationLevels.yaml | 23 + ...dminBatchInventoryItemsLocationLevels.yaml | 31 + ...hInventoryItemsLocationLevelsResponse.yaml | 21 + ...tchUpdateInventoryItemsLocationLevels.yaml | 27 + .../schemas/AdminShippingOptionRule.yaml | 40 +- .../components/schemas/InventoryLevel.yaml | 18 +- .../schemas/StoreProductTagListResponse.yaml | 26 + .../schemas/StoreProductTagResponse.yaml | 8 + .../schemas/StoreProductTypeListResponse.yaml | 26 + .../schemas/StoreProductTypeResponse.yaml | 8 + .../specs/admin/openapi.full.yaml | 307 +++++++--- ...inventory-items_location-levels_batch.yaml | 76 +-- .../Shell/store_product-tags/get.sh | 2 + .../Shell/store_product-tags_{id}/get.sh | 2 + .../Shell/store_product-types/get.sh | 2 + .../Shell/store_product-types_{id}/get.sh | 2 + ...tchCreateInventoryItemsLocationLevels.yaml | 23 + ...dminBatchInventoryItemsLocationLevels.yaml | 31 + ...hInventoryItemsLocationLevelsResponse.yaml | 21 + ...tchUpdateInventoryItemsLocationLevels.yaml | 27 + .../schemas/AdminShippingOptionRule.yaml | 40 +- .../components/schemas/InventoryLevel.yaml | 18 +- .../schemas/StoreProductTagListResponse.yaml | 26 + .../schemas/StoreProductTagResponse.yaml | 8 + .../schemas/StoreProductTypeListResponse.yaml | 26 + .../schemas/StoreProductTypeResponse.yaml | 8 + .../specs/store/openapi.full.yaml | 570 +++++++++++++++++- .../api-reference/specs/store/openapi.yaml | 12 + .../specs/store/paths/store_product-tags.yaml | 122 ++++ .../store/paths/store_product-tags_{id}.yaml | 65 ++ .../store/paths/store_product-types.yaml | 122 ++++ .../store/paths/store_product-types_{id}.yaml | 65 ++ .../oas-output/base/store.oas.base.yaml | 6 +- ...n_inventory-items_location-levels_batch.ts | 73 +-- .../store/get_store_product-tags.ts | 109 ++++ .../store/get_store_product-tags_[id].ts | 65 ++ .../store/get_store_product-types.ts | 109 ++++ .../store/get_store_product-types_[id].ts | 65 ++ ...BatchCreateInventoryItemsLocationLevels.ts | 28 + .../AdminBatchInventoryItemsLocationLevels.ts | 34 ++ ...tchInventoryItemsLocationLevelsResponse.ts | 26 + ...BatchUpdateInventoryItemsLocationLevels.ts | 32 + .../schemas/AdminShippingOptionRule.ts | 45 +- .../oas-output/schemas/InventoryLevel.ts | 18 +- .../schemas/StoreProductTagListResponse.ts | 31 + .../schemas/StoreProductTagResponse.ts | 13 + .../schemas/StoreProductTypeListResponse.ts | 31 + .../schemas/StoreProductTypeResponse.ts | 13 + 48 files changed, 2188 insertions(+), 313 deletions(-) create mode 100644 www/apps/api-reference/specs/admin/components/schemas/AdminBatchCreateInventoryItemsLocationLevels.yaml create mode 100644 www/apps/api-reference/specs/admin/components/schemas/AdminBatchInventoryItemsLocationLevels.yaml create mode 100644 www/apps/api-reference/specs/admin/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml create mode 100644 www/apps/api-reference/specs/admin/components/schemas/AdminBatchUpdateInventoryItemsLocationLevels.yaml create mode 100644 www/apps/api-reference/specs/admin/components/schemas/StoreProductTagListResponse.yaml create mode 100644 www/apps/api-reference/specs/admin/components/schemas/StoreProductTagResponse.yaml create mode 100644 www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeListResponse.yaml create mode 100644 www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeResponse.yaml create mode 100644 www/apps/api-reference/specs/store/code_samples/Shell/store_product-tags/get.sh create mode 100644 www/apps/api-reference/specs/store/code_samples/Shell/store_product-tags_{id}/get.sh create mode 100644 www/apps/api-reference/specs/store/code_samples/Shell/store_product-types/get.sh create mode 100644 www/apps/api-reference/specs/store/code_samples/Shell/store_product-types_{id}/get.sh create mode 100644 www/apps/api-reference/specs/store/components/schemas/AdminBatchCreateInventoryItemsLocationLevels.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/AdminBatchInventoryItemsLocationLevels.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/AdminBatchUpdateInventoryItemsLocationLevels.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/StoreProductTagListResponse.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/StoreProductTagResponse.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/StoreProductTypeListResponse.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/StoreProductTypeResponse.yaml create mode 100644 www/apps/api-reference/specs/store/paths/store_product-tags.yaml create mode 100644 www/apps/api-reference/specs/store/paths/store_product-tags_{id}.yaml create mode 100644 www/apps/api-reference/specs/store/paths/store_product-types.yaml create mode 100644 www/apps/api-reference/specs/store/paths/store_product-types_{id}.yaml create mode 100644 www/utils/generated/oas-output/operations/store/get_store_product-tags.ts create mode 100644 www/utils/generated/oas-output/operations/store/get_store_product-tags_[id].ts create mode 100644 www/utils/generated/oas-output/operations/store/get_store_product-types.ts create mode 100644 www/utils/generated/oas-output/operations/store/get_store_product-types_[id].ts create mode 100644 www/utils/generated/oas-output/schemas/AdminBatchCreateInventoryItemsLocationLevels.ts create mode 100644 www/utils/generated/oas-output/schemas/AdminBatchInventoryItemsLocationLevels.ts create mode 100644 www/utils/generated/oas-output/schemas/AdminBatchInventoryItemsLocationLevelsResponse.ts create mode 100644 www/utils/generated/oas-output/schemas/AdminBatchUpdateInventoryItemsLocationLevels.ts create mode 100644 www/utils/generated/oas-output/schemas/StoreProductTagListResponse.ts create mode 100644 www/utils/generated/oas-output/schemas/StoreProductTagResponse.ts create mode 100644 www/utils/generated/oas-output/schemas/StoreProductTypeListResponse.ts create mode 100644 www/utils/generated/oas-output/schemas/StoreProductTypeResponse.ts diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminBatchCreateInventoryItemsLocationLevels.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminBatchCreateInventoryItemsLocationLevels.yaml new file mode 100644 index 0000000000000..41c41d7f54271 --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminBatchCreateInventoryItemsLocationLevels.yaml @@ -0,0 +1,23 @@ +type: object +description: The details of an inventory level to create. +required: + - location_id + - inventory_item_id +properties: + location_id: + type: string + title: location_id + description: The ID of the associated stock location. + inventory_item_id: + type: string + title: inventory_item_id + description: The ID of the associated inventory item. + stocked_quantity: + type: number + title: stocked_quantity + description: The stocked quantity. + incoming_quantity: + type: number + title: incoming_quantity + description: The incoming quantity to be added to stock. +x-schemaName: AdminBatchCreateInventoryItemsLocationLevels diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminBatchInventoryItemsLocationLevels.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminBatchInventoryItemsLocationLevels.yaml new file mode 100644 index 0000000000000..7a281e21b402a --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminBatchInventoryItemsLocationLevels.yaml @@ -0,0 +1,31 @@ +type: object +description: The inventory levels to manage. +properties: + create: + type: array + description: The inventory levels to create. + items: + $ref: ./AdminBatchCreateInventoryItemsLocationLevels.yaml + update: + type: array + description: The inventory levels to update. + items: + $ref: ./AdminBatchUpdateInventoryItemsLocationLevels.yaml + delete: + type: array + description: The IDs of the inventory levels to delete. + items: + type: string + title: delete + description: The ID of the inventory level to delete. + force: + type: boolean + title: force + description: >- + Whether to delete specified inventory levels even if they have a non-zero + stocked quantity. +required: + - create + - update + - delete +x-schemaName: AdminBatchInventoryItemsLocationLevels diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml new file mode 100644 index 0000000000000..b6a778681e90e --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml @@ -0,0 +1,21 @@ +type: object +description: SUMMARY +x-schemaName: AdminBatchInventoryItemsLocationLevelsResponse +properties: + created: + type: array + description: The inventory item's created. + items: + $ref: ./InventoryLevel.yaml + updated: + type: array + description: The inventory item's updated. + items: + $ref: ./InventoryLevel.yaml + deleted: + type: array + description: SUMMARY + items: + type: string + title: deleted + description: SUMMARY diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminBatchUpdateInventoryItemsLocationLevels.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminBatchUpdateInventoryItemsLocationLevels.yaml new file mode 100644 index 0000000000000..fe7876b5ff1a2 --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminBatchUpdateInventoryItemsLocationLevels.yaml @@ -0,0 +1,27 @@ +type: object +description: The details of an inventory level to update. +required: + - location_id + - inventory_item_id +properties: + location_id: + type: string + title: location_id + description: The ID of the associated stock location. + inventory_item_id: + type: string + title: inventory_item_id + description: The ID of the associated inventory item. + stocked_quantity: + type: number + title: stocked_quantity + description: The stocked quantity. + incoming_quantity: + type: number + title: incoming_quantity + description: The incoming quantity to be added to stock. + id: + type: string + title: id + description: The update's ID. +x-schemaName: AdminBatchUpdateInventoryItemsLocationLevels diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminShippingOptionRule.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminShippingOptionRule.yaml index 1fcc34fd59075..5161a04d59a16 100644 --- a/www/apps/api-reference/specs/admin/components/schemas/AdminShippingOptionRule.yaml +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminShippingOptionRule.yaml @@ -1,5 +1,5 @@ type: object -description: The shipping option rule's details. +description: The rule's rules. x-schemaName: AdminShippingOptionRule required: - id @@ -14,36 +14,50 @@ properties: id: type: string title: id - description: The shipping option rule's ID. + description: The rule's ID. attribute: type: string title: attribute - description: The shipping option rule's attribute. - example: is_return + description: The rule's attribute. operator: type: string - title: operator - description: The shipping option rule's operator. - example: eq + description: The rule's operator. + enum: + - gt + - lt + - eq + - ne + - in + - lte + - gte + - nin value: - type: string - title: value + oneOf: + - type: string + title: value + description: The rule's value. + - type: array + description: The rule's value. + items: + type: string + title: value + description: The value's details. shipping_option_id: type: string title: shipping_option_id - description: The ID of the shipping option this rule is for. + description: The rule's shipping option id. created_at: type: string format: date-time title: created_at - description: The date the shipping option rule was created. + description: The rule's created at. updated_at: type: string format: date-time title: updated_at - description: The date the shipping option rule was updated. + description: The rule's updated at. deleted_at: type: string format: date-time title: deleted_at - description: The date the shipping option rule was deleted. + description: The rule's deleted at. diff --git a/www/apps/api-reference/specs/admin/components/schemas/InventoryLevel.yaml b/www/apps/api-reference/specs/admin/components/schemas/InventoryLevel.yaml index aa13bb7243bb5..658993eeab942 100644 --- a/www/apps/api-reference/specs/admin/components/schemas/InventoryLevel.yaml +++ b/www/apps/api-reference/specs/admin/components/schemas/InventoryLevel.yaml @@ -1,5 +1,5 @@ type: object -description: The inventory level's details +description: The created's details. x-schemaName: InventoryLevel required: - id @@ -13,31 +13,31 @@ properties: id: type: string title: id - description: The inventory level's ID. + description: The created's ID. inventory_item_id: type: string title: inventory_item_id - description: The ID of the associated inventory item. + description: The created's inventory item id. location_id: type: string title: location_id - description: The ID of the associated location. + description: The created's location id. stocked_quantity: type: number title: stocked_quantity - description: The inventory level's stocked quantity. + description: The created's stocked quantity. reserved_quantity: type: number title: reserved_quantity - description: The inventory level's reserved quantity. + description: The created's reserved quantity. available_quantity: type: number title: available_quantity - description: The inventory level's available quantity. + description: The created's available quantity. incoming_quantity: type: number title: incoming_quantity - description: The inventory level's incoming quantity. + description: The created's incoming quantity. metadata: type: object - description: The inventory level's metadata, can hold custom key-value pairs. + description: The created's metadata. diff --git a/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagListResponse.yaml b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagListResponse.yaml new file mode 100644 index 0000000000000..db5aee4f3a4d2 --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagListResponse.yaml @@ -0,0 +1,26 @@ +type: object +description: SUMMARY +x-schemaName: StoreProductTagListResponse +required: + - limit + - offset + - count + - product_tags +properties: + limit: + type: number + title: limit + description: The product tag's limit. + offset: + type: number + title: offset + description: The product tag's offset. + count: + type: number + title: count + description: The product tag's count. + product_tags: + type: array + description: The product tag's product tags. + items: + $ref: ./StoreProductTag.yaml diff --git a/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagResponse.yaml b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagResponse.yaml new file mode 100644 index 0000000000000..204949ffce4b8 --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagResponse.yaml @@ -0,0 +1,8 @@ +type: object +description: SUMMARY +x-schemaName: StoreProductTagResponse +required: + - product_tag +properties: + product_tag: + $ref: ./StoreProductTag.yaml diff --git a/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeListResponse.yaml b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeListResponse.yaml new file mode 100644 index 0000000000000..ad23d10f1b932 --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeListResponse.yaml @@ -0,0 +1,26 @@ +type: object +description: SUMMARY +x-schemaName: StoreProductTypeListResponse +required: + - limit + - offset + - count + - product_types +properties: + limit: + type: number + title: limit + description: The product type's limit. + offset: + type: number + title: offset + description: The product type's offset. + count: + type: number + title: count + description: The product type's count. + product_types: + type: array + description: The product type's product types. + items: + $ref: ./StoreProduct.yaml diff --git a/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeResponse.yaml b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeResponse.yaml new file mode 100644 index 0000000000000..3952e4b2b660d --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeResponse.yaml @@ -0,0 +1,8 @@ +type: object +description: SUMMARY +x-schemaName: StoreProductTypeResponse +required: + - product_type +properties: + product_type: + $ref: ./StoreProduct.yaml diff --git a/www/apps/api-reference/specs/admin/openapi.full.yaml b/www/apps/api-reference/specs/admin/openapi.full.yaml index bcf4eeea587b6..3988d4915307e 100644 --- a/www/apps/api-reference/specs/admin/openapi.full.yaml +++ b/www/apps/api-reference/specs/admin/openapi.full.yaml @@ -16709,72 +16709,7 @@ paths: content: application/json: schema: - type: object - description: The inventory levels to manage. - properties: - create: - type: array - description: The inventory levels to create. - items: - type: object - description: The details of an inventory level to create. - required: - - location_id - - inventory_item_id - properties: - location_id: - type: string - title: location_id - description: The ID of the associated stock location. - inventory_item_id: - type: string - title: inventory_item_id - description: The ID of the associated inventory item. - stocked_quantity: - type: number - title: stocked_quantity - description: The stocked quantity. - incoming_quantity: - type: number - title: incoming_quantity - description: The incoming quantity to be added to stock. - update: - type: array - description: The inventory levels to update. - items: - type: object - description: The details of an inventory level to update. - required: - - location_id - - inventory_item_id - properties: - location_id: - type: string - title: location_id - description: The ID of the associated stock location. - inventory_item_id: - type: string - title: inventory_item_id - description: The ID of the associated inventory item. - stocked_quantity: - type: number - title: stocked_quantity - description: The stocked quantity. - incoming_quantity: - type: number - title: incoming_quantity - description: The incoming quantity to be added to stock. - delete: - type: array - description: The IDs of the inventory levels to delete. - items: - type: string - title: delete - description: The ID of the inventory level to delete. - force: - type: boolean - title: force - description: Whether to delete specified inventory levels even if they have a non-zero stocked quantity. + $ref: '#/components/schemas/AdminBatchInventoryItemsLocationLevels' x-codeSamples: - lang: Shell label: cURL @@ -16806,6 +16741,12 @@ paths: tags: - Inventory Items responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse' '400': $ref: '#/components/responses/400_error' '401': @@ -43819,6 +43760,30 @@ components: type: number title: apply_to_quantity description: The quantity that results from matching the `buyget` promotion's condition. For example, if the promotion is a "Buy 2 shirts get 1 free", the value of this attribute is `1`. + AdminBatchCreateInventoryItemsLocationLevels: + type: object + description: The details of an inventory level to create. + required: + - location_id + - inventory_item_id + properties: + location_id: + type: string + title: location_id + description: The ID of the associated stock location. + inventory_item_id: + type: string + title: inventory_item_id + description: The ID of the associated inventory item. + stocked_quantity: + type: number + title: stocked_quantity + description: The stocked quantity. + incoming_quantity: + type: number + title: incoming_quantity + description: The incoming quantity to be added to stock. + x-schemaName: AdminBatchCreateInventoryItemsLocationLevels AdminBatchInventoryItemLocationsLevel: type: object description: The inventory levels to create, update, or delete. @@ -43881,6 +43846,58 @@ components: title: force description: Whether to delete specified inventory levels even if they have a non-zero stocked quantity. x-schemaName: AdminBatchInventoryItemLocationsLevel + AdminBatchInventoryItemsLocationLevels: + type: object + description: The inventory levels to manage. + properties: + create: + type: array + description: The inventory levels to create. + items: + $ref: '#/components/schemas/AdminBatchCreateInventoryItemsLocationLevels' + update: + type: array + description: The inventory levels to update. + items: + $ref: '#/components/schemas/AdminBatchUpdateInventoryItemsLocationLevels' + delete: + type: array + description: The IDs of the inventory levels to delete. + items: + type: string + title: delete + description: The ID of the inventory level to delete. + force: + type: boolean + title: force + description: Whether to delete specified inventory levels even if they have a non-zero stocked quantity. + required: + - create + - update + - delete + x-schemaName: AdminBatchInventoryItemsLocationLevels + AdminBatchInventoryItemsLocationLevelsResponse: + type: object + description: SUMMARY + x-schemaName: AdminBatchInventoryItemsLocationLevelsResponse + properties: + created: + type: array + description: The inventory item's created. + items: + $ref: '#/components/schemas/InventoryLevel' + updated: + type: array + description: The inventory item's updated. + items: + $ref: '#/components/schemas/InventoryLevel' + deleted: + type: array + description: SUMMARY + items: + type: string + title: deleted + description: SUMMARY AdminBatchProductRequest: type: object description: The products to create, update, or delete. @@ -44011,6 +44028,34 @@ components: type: boolean title: deleted description: Whether the product variants were deleted. + AdminBatchUpdateInventoryItemsLocationLevels: + type: object + description: The details of an inventory level to update. + required: + - location_id + - inventory_item_id + properties: + location_id: + type: string + title: location_id + description: The ID of the associated stock location. + inventory_item_id: + type: string + title: inventory_item_id + description: The ID of the associated inventory item. + stocked_quantity: + type: number + title: stocked_quantity + description: The stocked quantity. + incoming_quantity: + type: number + title: incoming_quantity + description: The incoming quantity to be added to stock. + id: + type: string + title: id + description: The update's ID. + x-schemaName: AdminBatchUpdateInventoryItemsLocationLevels AdminBatchUpdateProduct: type: object description: The product's details. @@ -53259,7 +53304,7 @@ components: $ref: '#/components/schemas/AdminShippingOption' AdminShippingOptionRule: type: object - description: The shipping option rule's details. + description: The rule's rules. x-schemaName: AdminShippingOptionRule required: - id @@ -53274,39 +53319,53 @@ components: id: type: string title: id - description: The shipping option rule's ID. + description: The rule's ID. attribute: type: string title: attribute - description: The shipping option rule's attribute. - example: is_return + description: The rule's attribute. operator: type: string - title: operator - description: The shipping option rule's operator. - example: eq + description: The rule's operator. + enum: + - gt + - lt + - eq + - ne + - in + - lte + - gte + - nin value: - type: string - title: value + oneOf: + - type: string + title: value + description: The rule's value. + - type: array + description: The rule's value. + items: + type: string + title: value + description: The value's details. shipping_option_id: type: string title: shipping_option_id - description: The ID of the shipping option this rule is for. + description: The rule's shipping option id. created_at: type: string format: date-time title: created_at - description: The date the shipping option rule was created. + description: The rule's created at. updated_at: type: string format: date-time title: updated_at - description: The date the shipping option rule was updated. + description: The rule's updated at. deleted_at: type: string format: date-time title: deleted_at - description: The date the shipping option rule was deleted. + description: The rule's deleted at. AdminShippingOptionType: type: object description: The shipping option's details. @@ -58874,7 +58933,7 @@ components: - unknown_error InventoryLevel: type: object - description: The inventory level's details + description: The created's details. x-schemaName: InventoryLevel required: - id @@ -58888,34 +58947,34 @@ components: id: type: string title: id - description: The inventory level's ID. + description: The created's ID. inventory_item_id: type: string title: inventory_item_id - description: The ID of the associated inventory item. + description: The created's inventory item id. location_id: type: string title: location_id - description: The ID of the associated location. + description: The created's location id. stocked_quantity: type: number title: stocked_quantity - description: The inventory level's stocked quantity. + description: The created's stocked quantity. reserved_quantity: type: number title: reserved_quantity - description: The inventory level's reserved quantity. + description: The created's reserved quantity. available_quantity: type: number title: available_quantity - description: The inventory level's available quantity. + description: The created's available quantity. incoming_quantity: type: number title: incoming_quantity - description: The inventory level's incoming quantity. + description: The created's incoming quantity. metadata: type: object - description: The inventory level's metadata, can hold custom key-value pairs. + description: The created's metadata. Order: type: object description: The order change's order. @@ -69028,6 +69087,78 @@ components: - value - created_at - updated_at + StoreProductTagListResponse: + type: object + description: SUMMARY + x-schemaName: StoreProductTagListResponse + required: + - limit + - offset + - count + - product_tags + properties: + limit: + type: number + title: limit + description: The product tag's limit. + offset: + type: number + title: offset + description: The product tag's offset. + count: + type: number + title: count + description: The product tag's count. + product_tags: + type: array + description: The product tag's product tags. + items: + $ref: '#/components/schemas/StoreProductTag' + StoreProductTagResponse: + type: object + description: SUMMARY + x-schemaName: StoreProductTagResponse + required: + - product_tag + properties: + product_tag: + $ref: '#/components/schemas/StoreProductTag' + StoreProductTypeListResponse: + type: object + description: SUMMARY + x-schemaName: StoreProductTypeListResponse + required: + - limit + - offset + - count + - product_types + properties: + limit: + type: number + title: limit + description: The product type's limit. + offset: + type: number + title: offset + description: The product type's offset. + count: + type: number + title: count + description: The product type's count. + product_types: + type: array + description: The product type's product types. + items: + $ref: '#/components/schemas/StoreProduct' + StoreProductTypeResponse: + type: object + description: SUMMARY + x-schemaName: StoreProductTypeResponse + required: + - product_type + properties: + product_type: + $ref: '#/components/schemas/StoreProduct' StoreProductVariant: type: object description: The variant's details. diff --git a/www/apps/api-reference/specs/admin/paths/admin_inventory-items_location-levels_batch.yaml b/www/apps/api-reference/specs/admin/paths/admin_inventory-items_location-levels_batch.yaml index bc9d3c17eba20..d49d51cb227d1 100644 --- a/www/apps/api-reference/specs/admin/paths/admin_inventory-items_location-levels_batch.yaml +++ b/www/apps/api-reference/specs/admin/paths/admin_inventory-items_location-levels_batch.yaml @@ -11,74 +11,7 @@ post: content: application/json: schema: - type: object - description: The inventory levels to manage. - properties: - create: - type: array - description: The inventory levels to create. - items: - type: object - description: The details of an inventory level to create. - required: - - location_id - - inventory_item_id - properties: - location_id: - type: string - title: location_id - description: The ID of the associated stock location. - inventory_item_id: - type: string - title: inventory_item_id - description: The ID of the associated inventory item. - stocked_quantity: - type: number - title: stocked_quantity - description: The stocked quantity. - incoming_quantity: - type: number - title: incoming_quantity - description: The incoming quantity to be added to stock. - update: - type: array - description: The inventory levels to update. - items: - type: object - description: The details of an inventory level to update. - required: - - location_id - - inventory_item_id - properties: - location_id: - type: string - title: location_id - description: The ID of the associated stock location. - inventory_item_id: - type: string - title: inventory_item_id - description: The ID of the associated inventory item. - stocked_quantity: - type: number - title: stocked_quantity - description: The stocked quantity. - incoming_quantity: - type: number - title: incoming_quantity - description: The incoming quantity to be added to stock. - delete: - type: array - description: The IDs of the inventory levels to delete. - items: - type: string - title: delete - description: The ID of the inventory level to delete. - force: - type: boolean - title: force - description: >- - Whether to delete specified inventory levels even if they have a - non-zero stocked quantity. + $ref: ../components/schemas/AdminBatchInventoryItemsLocationLevels.yaml x-codeSamples: - lang: Shell label: cURL @@ -88,6 +21,13 @@ post: tags: - Inventory Items responses: + '200': + description: OK + content: + application/json: + schema: + $ref: >- + ../components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml '400': $ref: ../components/responses/400_error.yaml '401': diff --git a/www/apps/api-reference/specs/store/code_samples/Shell/store_product-tags/get.sh b/www/apps/api-reference/specs/store/code_samples/Shell/store_product-tags/get.sh new file mode 100644 index 0000000000000..9e3d56ff0fee9 --- /dev/null +++ b/www/apps/api-reference/specs/store/code_samples/Shell/store_product-tags/get.sh @@ -0,0 +1,2 @@ +curl '{backend_url}/store/product-tags' \ +-H 'x-publishable-api-key: {your_publishable_api_key}' \ No newline at end of file diff --git a/www/apps/api-reference/specs/store/code_samples/Shell/store_product-tags_{id}/get.sh b/www/apps/api-reference/specs/store/code_samples/Shell/store_product-tags_{id}/get.sh new file mode 100644 index 0000000000000..cdcad486e0069 --- /dev/null +++ b/www/apps/api-reference/specs/store/code_samples/Shell/store_product-tags_{id}/get.sh @@ -0,0 +1,2 @@ +curl '{backend_url}/store/product-tags/{id}' \ +-H 'x-publishable-api-key: {your_publishable_api_key}' \ No newline at end of file diff --git a/www/apps/api-reference/specs/store/code_samples/Shell/store_product-types/get.sh b/www/apps/api-reference/specs/store/code_samples/Shell/store_product-types/get.sh new file mode 100644 index 0000000000000..acfb949b151cb --- /dev/null +++ b/www/apps/api-reference/specs/store/code_samples/Shell/store_product-types/get.sh @@ -0,0 +1,2 @@ +curl '{backend_url}/store/product-types' \ +-H 'x-publishable-api-key: {your_publishable_api_key}' \ No newline at end of file diff --git a/www/apps/api-reference/specs/store/code_samples/Shell/store_product-types_{id}/get.sh b/www/apps/api-reference/specs/store/code_samples/Shell/store_product-types_{id}/get.sh new file mode 100644 index 0000000000000..e64bb420c103f --- /dev/null +++ b/www/apps/api-reference/specs/store/code_samples/Shell/store_product-types_{id}/get.sh @@ -0,0 +1,2 @@ +curl '{backend_url}/store/product-types/{id}' \ +-H 'x-publishable-api-key: {your_publishable_api_key}' \ No newline at end of file diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminBatchCreateInventoryItemsLocationLevels.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminBatchCreateInventoryItemsLocationLevels.yaml new file mode 100644 index 0000000000000..41c41d7f54271 --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/AdminBatchCreateInventoryItemsLocationLevels.yaml @@ -0,0 +1,23 @@ +type: object +description: The details of an inventory level to create. +required: + - location_id + - inventory_item_id +properties: + location_id: + type: string + title: location_id + description: The ID of the associated stock location. + inventory_item_id: + type: string + title: inventory_item_id + description: The ID of the associated inventory item. + stocked_quantity: + type: number + title: stocked_quantity + description: The stocked quantity. + incoming_quantity: + type: number + title: incoming_quantity + description: The incoming quantity to be added to stock. +x-schemaName: AdminBatchCreateInventoryItemsLocationLevels diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminBatchInventoryItemsLocationLevels.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminBatchInventoryItemsLocationLevels.yaml new file mode 100644 index 0000000000000..7a281e21b402a --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/AdminBatchInventoryItemsLocationLevels.yaml @@ -0,0 +1,31 @@ +type: object +description: The inventory levels to manage. +properties: + create: + type: array + description: The inventory levels to create. + items: + $ref: ./AdminBatchCreateInventoryItemsLocationLevels.yaml + update: + type: array + description: The inventory levels to update. + items: + $ref: ./AdminBatchUpdateInventoryItemsLocationLevels.yaml + delete: + type: array + description: The IDs of the inventory levels to delete. + items: + type: string + title: delete + description: The ID of the inventory level to delete. + force: + type: boolean + title: force + description: >- + Whether to delete specified inventory levels even if they have a non-zero + stocked quantity. +required: + - create + - update + - delete +x-schemaName: AdminBatchInventoryItemsLocationLevels diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml new file mode 100644 index 0000000000000..b6a778681e90e --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml @@ -0,0 +1,21 @@ +type: object +description: SUMMARY +x-schemaName: AdminBatchInventoryItemsLocationLevelsResponse +properties: + created: + type: array + description: The inventory item's created. + items: + $ref: ./InventoryLevel.yaml + updated: + type: array + description: The inventory item's updated. + items: + $ref: ./InventoryLevel.yaml + deleted: + type: array + description: SUMMARY + items: + type: string + title: deleted + description: SUMMARY diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminBatchUpdateInventoryItemsLocationLevels.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminBatchUpdateInventoryItemsLocationLevels.yaml new file mode 100644 index 0000000000000..fe7876b5ff1a2 --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/AdminBatchUpdateInventoryItemsLocationLevels.yaml @@ -0,0 +1,27 @@ +type: object +description: The details of an inventory level to update. +required: + - location_id + - inventory_item_id +properties: + location_id: + type: string + title: location_id + description: The ID of the associated stock location. + inventory_item_id: + type: string + title: inventory_item_id + description: The ID of the associated inventory item. + stocked_quantity: + type: number + title: stocked_quantity + description: The stocked quantity. + incoming_quantity: + type: number + title: incoming_quantity + description: The incoming quantity to be added to stock. + id: + type: string + title: id + description: The update's ID. +x-schemaName: AdminBatchUpdateInventoryItemsLocationLevels diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminShippingOptionRule.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminShippingOptionRule.yaml index 1fcc34fd59075..5161a04d59a16 100644 --- a/www/apps/api-reference/specs/store/components/schemas/AdminShippingOptionRule.yaml +++ b/www/apps/api-reference/specs/store/components/schemas/AdminShippingOptionRule.yaml @@ -1,5 +1,5 @@ type: object -description: The shipping option rule's details. +description: The rule's rules. x-schemaName: AdminShippingOptionRule required: - id @@ -14,36 +14,50 @@ properties: id: type: string title: id - description: The shipping option rule's ID. + description: The rule's ID. attribute: type: string title: attribute - description: The shipping option rule's attribute. - example: is_return + description: The rule's attribute. operator: type: string - title: operator - description: The shipping option rule's operator. - example: eq + description: The rule's operator. + enum: + - gt + - lt + - eq + - ne + - in + - lte + - gte + - nin value: - type: string - title: value + oneOf: + - type: string + title: value + description: The rule's value. + - type: array + description: The rule's value. + items: + type: string + title: value + description: The value's details. shipping_option_id: type: string title: shipping_option_id - description: The ID of the shipping option this rule is for. + description: The rule's shipping option id. created_at: type: string format: date-time title: created_at - description: The date the shipping option rule was created. + description: The rule's created at. updated_at: type: string format: date-time title: updated_at - description: The date the shipping option rule was updated. + description: The rule's updated at. deleted_at: type: string format: date-time title: deleted_at - description: The date the shipping option rule was deleted. + description: The rule's deleted at. diff --git a/www/apps/api-reference/specs/store/components/schemas/InventoryLevel.yaml b/www/apps/api-reference/specs/store/components/schemas/InventoryLevel.yaml index aa13bb7243bb5..658993eeab942 100644 --- a/www/apps/api-reference/specs/store/components/schemas/InventoryLevel.yaml +++ b/www/apps/api-reference/specs/store/components/schemas/InventoryLevel.yaml @@ -1,5 +1,5 @@ type: object -description: The inventory level's details +description: The created's details. x-schemaName: InventoryLevel required: - id @@ -13,31 +13,31 @@ properties: id: type: string title: id - description: The inventory level's ID. + description: The created's ID. inventory_item_id: type: string title: inventory_item_id - description: The ID of the associated inventory item. + description: The created's inventory item id. location_id: type: string title: location_id - description: The ID of the associated location. + description: The created's location id. stocked_quantity: type: number title: stocked_quantity - description: The inventory level's stocked quantity. + description: The created's stocked quantity. reserved_quantity: type: number title: reserved_quantity - description: The inventory level's reserved quantity. + description: The created's reserved quantity. available_quantity: type: number title: available_quantity - description: The inventory level's available quantity. + description: The created's available quantity. incoming_quantity: type: number title: incoming_quantity - description: The inventory level's incoming quantity. + description: The created's incoming quantity. metadata: type: object - description: The inventory level's metadata, can hold custom key-value pairs. + description: The created's metadata. diff --git a/www/apps/api-reference/specs/store/components/schemas/StoreProductTagListResponse.yaml b/www/apps/api-reference/specs/store/components/schemas/StoreProductTagListResponse.yaml new file mode 100644 index 0000000000000..db5aee4f3a4d2 --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/StoreProductTagListResponse.yaml @@ -0,0 +1,26 @@ +type: object +description: SUMMARY +x-schemaName: StoreProductTagListResponse +required: + - limit + - offset + - count + - product_tags +properties: + limit: + type: number + title: limit + description: The product tag's limit. + offset: + type: number + title: offset + description: The product tag's offset. + count: + type: number + title: count + description: The product tag's count. + product_tags: + type: array + description: The product tag's product tags. + items: + $ref: ./StoreProductTag.yaml diff --git a/www/apps/api-reference/specs/store/components/schemas/StoreProductTagResponse.yaml b/www/apps/api-reference/specs/store/components/schemas/StoreProductTagResponse.yaml new file mode 100644 index 0000000000000..204949ffce4b8 --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/StoreProductTagResponse.yaml @@ -0,0 +1,8 @@ +type: object +description: SUMMARY +x-schemaName: StoreProductTagResponse +required: + - product_tag +properties: + product_tag: + $ref: ./StoreProductTag.yaml diff --git a/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeListResponse.yaml b/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeListResponse.yaml new file mode 100644 index 0000000000000..ad23d10f1b932 --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeListResponse.yaml @@ -0,0 +1,26 @@ +type: object +description: SUMMARY +x-schemaName: StoreProductTypeListResponse +required: + - limit + - offset + - count + - product_types +properties: + limit: + type: number + title: limit + description: The product type's limit. + offset: + type: number + title: offset + description: The product type's offset. + count: + type: number + title: count + description: The product type's count. + product_types: + type: array + description: The product type's product types. + items: + $ref: ./StoreProduct.yaml diff --git a/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeResponse.yaml b/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeResponse.yaml new file mode 100644 index 0000000000000..3952e4b2b660d --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeResponse.yaml @@ -0,0 +1,8 @@ +type: object +description: SUMMARY +x-schemaName: StoreProductTypeResponse +required: + - product_type +properties: + product_type: + $ref: ./StoreProduct.yaml diff --git a/www/apps/api-reference/specs/store/openapi.full.yaml b/www/apps/api-reference/specs/store/openapi.full.yaml index 0f902d6a501ae..bbcfb9302a6b0 100644 --- a/www/apps/api-reference/specs/store/openapi.full.yaml +++ b/www/apps/api-reference/specs/store/openapi.full.yaml @@ -97,6 +97,10 @@ tags: url: https://docs.medusajs.com/v2/resources/storefront-development/products/categories/list x-associatedSchema: $ref: '#/components/schemas/StoreProductCategory' + - name: Product Tags + x-associatedSchema: + $ref: '#/components/schemas/StoreProductTag' + - name: Product Types - name: Products description: | Customers browse products for their purchase. @@ -4631,6 +4635,338 @@ paths: $ref: '#/components/responses/invalid_request_error' '500': $ref: '#/components/responses/500_error' + /store/product-tags: + get: + operationId: GetProductTags + summary: List Product Tags + description: Retrieve a list of product tags. The product tags can be filtered by fields such as `id`. The product tags can also be sorted or paginated. + x-authenticated: false + parameters: + - name: x-publishable-api-key + in: header + description: Publishable API Key created in the Medusa Admin. + required: true + schema: + type: string + externalDocs: + url: https://docs.medusajs.com/api/store#publishable-api-key + - name: fields + in: query + description: |- + Comma-separated fields that should be included in the returned data. + * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * without prefix it will replace the entire default fields. + required: false + schema: + type: string + title: fields + description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + - name: offset + in: query + description: The number of items to skip when retrieving a list. + required: false + schema: + type: number + title: offset + description: The number of items to skip when retrieving a list. + externalDocs: + url: '#pagination' + - name: limit + in: query + description: Limit the number of items returned in the list. + required: false + schema: + type: number + title: limit + description: Limit the number of items returned in the list. + externalDocs: + url: '#pagination' + - name: order + in: query + description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + required: false + schema: + type: string + title: order + description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + externalDocs: + url: '#pagination' + - name: $and + in: query + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + required: false + schema: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + - name: $or + in: query + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + required: false + schema: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl '{backend_url}/store/product-tags' \ + -H 'x-publishable-api-key: {your_publishable_api_key}' + tags: + - Product Tags + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/StoreProductTagListResponse' + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' + /store/product-tags/{id}: + get: + operationId: GetProductTagsId + summary: Get a Product Tag + description: Retrieve a product tag by its ID. You can expand the product tag's relations or select the fields that should be returned. + x-authenticated: false + parameters: + - name: id + in: path + description: The product tag's ID. + required: true + schema: + type: string + - name: x-publishable-api-key + in: header + description: Publishable API Key created in the Medusa Admin. + required: true + schema: + type: string + externalDocs: + url: https://docs.medusajs.com/api/store#publishable-api-key + - name: fields + in: query + description: |- + Comma-separated fields that should be included in the returned data. + * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * without prefix it will replace the entire default fields. + required: false + schema: + type: string + title: fields + description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl '{backend_url}/store/product-tags/{id}' \ + -H 'x-publishable-api-key: {your_publishable_api_key}' + tags: + - Product Tags + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/StoreProductTagResponse' + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' + /store/product-types: + get: + operationId: GetProductTypes + summary: List Product Types + description: Retrieve a list of product types. The product types can be filtered by fields such as `id`. The product types can also be sorted or paginated. + x-authenticated: false + parameters: + - name: x-publishable-api-key + in: header + description: Publishable API Key created in the Medusa Admin. + required: true + schema: + type: string + externalDocs: + url: https://docs.medusajs.com/api/store#publishable-api-key + - name: fields + in: query + description: |- + Comma-separated fields that should be included in the returned data. + * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * without prefix it will replace the entire default fields. + required: false + schema: + type: string + title: fields + description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + - name: offset + in: query + description: The number of items to skip when retrieving a list. + required: false + schema: + type: number + title: offset + description: The number of items to skip when retrieving a list. + externalDocs: + url: '#pagination' + - name: limit + in: query + description: Limit the number of items returned in the list. + required: false + schema: + type: number + title: limit + description: Limit the number of items returned in the list. + externalDocs: + url: '#pagination' + - name: order + in: query + description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + required: false + schema: + type: string + title: order + description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + externalDocs: + url: '#pagination' + - name: $and + in: query + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + required: false + schema: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + - name: $or + in: query + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + required: false + schema: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl '{backend_url}/store/product-types' \ + -H 'x-publishable-api-key: {your_publishable_api_key}' + tags: + - Product Types + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/StoreProductTypeListResponse' + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' + /store/product-types/{id}: + get: + operationId: GetProductTypesId + summary: Get a Product Type + description: Retrieve a product type by its ID. You can expand the product type's relations or select the fields that should be returned. + x-authenticated: false + parameters: + - name: id + in: path + description: The product type's ID. + required: true + schema: + type: string + - name: x-publishable-api-key + in: header + description: Publishable API Key created in the Medusa Admin. + required: true + schema: + type: string + externalDocs: + url: https://docs.medusajs.com/api/store#publishable-api-key + - name: fields + in: query + description: |- + Comma-separated fields that should be included in the returned data. + * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * without prefix it will replace the entire default fields. + required: false + schema: + type: string + title: fields + description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl '{backend_url}/store/product-types/{id}' \ + -H 'x-publishable-api-key: {your_publishable_api_key}' + tags: + - Product Types + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/StoreProductTypeResponse' + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' /store/products: get: operationId: GetProducts @@ -6373,6 +6709,30 @@ components: type: number title: apply_to_quantity description: The quantity that results from matching the `buyget` promotion's condition. For example, if the promotion is a "Buy 2 shirts get 1 free", the value of this attribute is `1`. + AdminBatchCreateInventoryItemsLocationLevels: + type: object + description: The details of an inventory level to create. + required: + - location_id + - inventory_item_id + properties: + location_id: + type: string + title: location_id + description: The ID of the associated stock location. + inventory_item_id: + type: string + title: inventory_item_id + description: The ID of the associated inventory item. + stocked_quantity: + type: number + title: stocked_quantity + description: The stocked quantity. + incoming_quantity: + type: number + title: incoming_quantity + description: The incoming quantity to be added to stock. + x-schemaName: AdminBatchCreateInventoryItemsLocationLevels AdminBatchInventoryItemLocationsLevel: type: object description: The inventory levels to create, update, or delete. @@ -6435,6 +6795,58 @@ components: title: force description: Whether to delete specified inventory levels even if they have a non-zero stocked quantity. x-schemaName: AdminBatchInventoryItemLocationsLevel + AdminBatchInventoryItemsLocationLevels: + type: object + description: The inventory levels to manage. + properties: + create: + type: array + description: The inventory levels to create. + items: + $ref: '#/components/schemas/AdminBatchCreateInventoryItemsLocationLevels' + update: + type: array + description: The inventory levels to update. + items: + $ref: '#/components/schemas/AdminBatchUpdateInventoryItemsLocationLevels' + delete: + type: array + description: The IDs of the inventory levels to delete. + items: + type: string + title: delete + description: The ID of the inventory level to delete. + force: + type: boolean + title: force + description: Whether to delete specified inventory levels even if they have a non-zero stocked quantity. + required: + - create + - update + - delete + x-schemaName: AdminBatchInventoryItemsLocationLevels + AdminBatchInventoryItemsLocationLevelsResponse: + type: object + description: SUMMARY + x-schemaName: AdminBatchInventoryItemsLocationLevelsResponse + properties: + created: + type: array + description: The inventory item's created. + items: + $ref: '#/components/schemas/InventoryLevel' + updated: + type: array + description: The inventory item's updated. + items: + $ref: '#/components/schemas/InventoryLevel' + deleted: + type: array + description: SUMMARY + items: + type: string + title: deleted + description: SUMMARY AdminBatchProductRequest: type: object description: The products to create, update, or delete. @@ -6565,6 +6977,34 @@ components: type: boolean title: deleted description: Whether the product variants were deleted. + AdminBatchUpdateInventoryItemsLocationLevels: + type: object + description: The details of an inventory level to update. + required: + - location_id + - inventory_item_id + properties: + location_id: + type: string + title: location_id + description: The ID of the associated stock location. + inventory_item_id: + type: string + title: inventory_item_id + description: The ID of the associated inventory item. + stocked_quantity: + type: number + title: stocked_quantity + description: The stocked quantity. + incoming_quantity: + type: number + title: incoming_quantity + description: The incoming quantity to be added to stock. + id: + type: string + title: id + description: The update's ID. + x-schemaName: AdminBatchUpdateInventoryItemsLocationLevels AdminBatchUpdateProduct: type: object description: The product's details. @@ -15813,7 +16253,7 @@ components: $ref: '#/components/schemas/AdminShippingOption' AdminShippingOptionRule: type: object - description: The shipping option rule's details. + description: The rule's rules. x-schemaName: AdminShippingOptionRule required: - id @@ -15828,39 +16268,53 @@ components: id: type: string title: id - description: The shipping option rule's ID. + description: The rule's ID. attribute: type: string title: attribute - description: The shipping option rule's attribute. - example: is_return + description: The rule's attribute. operator: type: string - title: operator - description: The shipping option rule's operator. - example: eq + description: The rule's operator. + enum: + - gt + - lt + - eq + - ne + - in + - lte + - gte + - nin value: - type: string - title: value + oneOf: + - type: string + title: value + description: The rule's value. + - type: array + description: The rule's value. + items: + type: string + title: value + description: The value's details. shipping_option_id: type: string title: shipping_option_id - description: The ID of the shipping option this rule is for. + description: The rule's shipping option id. created_at: type: string format: date-time title: created_at - description: The date the shipping option rule was created. + description: The rule's created at. updated_at: type: string format: date-time title: updated_at - description: The date the shipping option rule was updated. + description: The rule's updated at. deleted_at: type: string format: date-time title: deleted_at - description: The date the shipping option rule was deleted. + description: The rule's deleted at. AdminShippingOptionType: type: object description: The shipping option's details. @@ -21428,7 +21882,7 @@ components: - unknown_error InventoryLevel: type: object - description: The inventory level's details + description: The created's details. x-schemaName: InventoryLevel required: - id @@ -21442,34 +21896,34 @@ components: id: type: string title: id - description: The inventory level's ID. + description: The created's ID. inventory_item_id: type: string title: inventory_item_id - description: The ID of the associated inventory item. + description: The created's inventory item id. location_id: type: string title: location_id - description: The ID of the associated location. + description: The created's location id. stocked_quantity: type: number title: stocked_quantity - description: The inventory level's stocked quantity. + description: The created's stocked quantity. reserved_quantity: type: number title: reserved_quantity - description: The inventory level's reserved quantity. + description: The created's reserved quantity. available_quantity: type: number title: available_quantity - description: The inventory level's available quantity. + description: The created's available quantity. incoming_quantity: type: number title: incoming_quantity - description: The inventory level's incoming quantity. + description: The created's incoming quantity. metadata: type: object - description: The inventory level's metadata, can hold custom key-value pairs. + description: The created's metadata. Order: type: object description: The order change's order. @@ -31582,6 +32036,78 @@ components: - value - created_at - updated_at + StoreProductTagListResponse: + type: object + description: SUMMARY + x-schemaName: StoreProductTagListResponse + required: + - limit + - offset + - count + - product_tags + properties: + limit: + type: number + title: limit + description: The product tag's limit. + offset: + type: number + title: offset + description: The product tag's offset. + count: + type: number + title: count + description: The product tag's count. + product_tags: + type: array + description: The product tag's product tags. + items: + $ref: '#/components/schemas/StoreProductTag' + StoreProductTagResponse: + type: object + description: SUMMARY + x-schemaName: StoreProductTagResponse + required: + - product_tag + properties: + product_tag: + $ref: '#/components/schemas/StoreProductTag' + StoreProductTypeListResponse: + type: object + description: SUMMARY + x-schemaName: StoreProductTypeListResponse + required: + - limit + - offset + - count + - product_types + properties: + limit: + type: number + title: limit + description: The product type's limit. + offset: + type: number + title: offset + description: The product type's offset. + count: + type: number + title: count + description: The product type's count. + product_types: + type: array + description: The product type's product types. + items: + $ref: '#/components/schemas/StoreProduct' + StoreProductTypeResponse: + type: object + description: SUMMARY + x-schemaName: StoreProductTypeResponse + required: + - product_type + properties: + product_type: + $ref: '#/components/schemas/StoreProduct' StoreProductVariant: type: object description: The variant's details. diff --git a/www/apps/api-reference/specs/store/openapi.yaml b/www/apps/api-reference/specs/store/openapi.yaml index 88e280ddb3c3e..ca01ec3f12ae4 100644 --- a/www/apps/api-reference/specs/store/openapi.yaml +++ b/www/apps/api-reference/specs/store/openapi.yaml @@ -122,6 +122,10 @@ tags: https://docs.medusajs.com/v2/resources/storefront-development/products/categories/list x-associatedSchema: $ref: ./components/schemas/StoreProductCategory.yaml + - name: Product Tags + x-associatedSchema: + $ref: ./components/schemas/StoreProductTag.yaml + - name: Product Types - name: Products description: > Customers browse products for their purchase. @@ -259,6 +263,14 @@ paths: $ref: paths/store_product-categories.yaml /store/product-categories/{id}: $ref: paths/store_product-categories_{id}.yaml + /store/product-tags: + $ref: paths/store_product-tags.yaml + /store/product-tags/{id}: + $ref: paths/store_product-tags_{id}.yaml + /store/product-types: + $ref: paths/store_product-types.yaml + /store/product-types/{id}: + $ref: paths/store_product-types_{id}.yaml /store/products: $ref: paths/store_products.yaml /store/products/{id}: diff --git a/www/apps/api-reference/specs/store/paths/store_product-tags.yaml b/www/apps/api-reference/specs/store/paths/store_product-tags.yaml new file mode 100644 index 0000000000000..6d77106be023d --- /dev/null +++ b/www/apps/api-reference/specs/store/paths/store_product-tags.yaml @@ -0,0 +1,122 @@ +get: + operationId: GetProductTags + summary: List Product Tags + description: >- + Retrieve a list of product tags. The product tags can be filtered by fields + such as `id`. The product tags can also be sorted or paginated. + x-authenticated: false + parameters: + - name: x-publishable-api-key + in: header + description: Publishable API Key created in the Medusa Admin. + required: true + schema: + type: string + externalDocs: + url: https://docs.medusajs.com/api/store#publishable-api-key + - name: fields + in: query + description: |- + Comma-separated fields that should be included in the returned data. + * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * without prefix it will replace the entire default fields. + required: false + schema: + type: string + title: fields + description: >- + Comma-separated fields that should be included in the returned data. + If a field is prefixed with `+` it will be added to the default + fields, using `-` will remove it from the default fields. Without + prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + - name: offset + in: query + description: The number of items to skip when retrieving a list. + required: false + schema: + type: number + title: offset + description: The number of items to skip when retrieving a list. + externalDocs: + url: '#pagination' + - name: limit + in: query + description: Limit the number of items returned in the list. + required: false + schema: + type: number + title: limit + description: Limit the number of items returned in the list. + externalDocs: + url: '#pagination' + - name: order + in: query + description: >- + The field to sort the data by. By default, the sort order is ascending. + To change the order to descending, prefix the field name with `-`. + required: false + schema: + type: string + title: order + description: >- + The field to sort the data by. By default, the sort order is + ascending. To change the order to descending, prefix the field name + with `-`. + externalDocs: + url: '#pagination' + - name: $and + in: query + description: >- + Join query parameters with an AND condition. Each object's content is + the same type as the expected query parameters. + required: false + schema: + type: array + description: >- + Join query parameters with an AND condition. Each object's content is + the same type as the expected query parameters. + items: + type: object + title: $and + - name: $or + in: query + description: >- + Join query parameters with an OR condition. Each object's content is the + same type as the expected query parameters. + required: false + schema: + type: array + description: >- + Join query parameters with an OR condition. Each object's content is + the same type as the expected query parameters. + items: + type: object + title: $or + x-codeSamples: + - lang: Shell + label: cURL + source: + $ref: ../code_samples/Shell/store_product-tags/get.sh + tags: + - Product Tags + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: ../components/schemas/StoreProductTagListResponse.yaml + '400': + $ref: ../components/responses/400_error.yaml + '401': + $ref: ../components/responses/unauthorized.yaml + '404': + $ref: ../components/responses/not_found_error.yaml + '409': + $ref: ../components/responses/invalid_state_error.yaml + '422': + $ref: ../components/responses/invalid_request_error.yaml + '500': + $ref: ../components/responses/500_error.yaml diff --git a/www/apps/api-reference/specs/store/paths/store_product-tags_{id}.yaml b/www/apps/api-reference/specs/store/paths/store_product-tags_{id}.yaml new file mode 100644 index 0000000000000..e5434364368a1 --- /dev/null +++ b/www/apps/api-reference/specs/store/paths/store_product-tags_{id}.yaml @@ -0,0 +1,65 @@ +get: + operationId: GetProductTagsId + summary: Get a Product Tag + description: >- + Retrieve a product tag by its ID. You can expand the product tag's relations + or select the fields that should be returned. + x-authenticated: false + parameters: + - name: id + in: path + description: The product tag's ID. + required: true + schema: + type: string + - name: x-publishable-api-key + in: header + description: Publishable API Key created in the Medusa Admin. + required: true + schema: + type: string + externalDocs: + url: https://docs.medusajs.com/api/store#publishable-api-key + - name: fields + in: query + description: |- + Comma-separated fields that should be included in the returned data. + * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * without prefix it will replace the entire default fields. + required: false + schema: + type: string + title: fields + description: >- + Comma-separated fields that should be included in the returned data. + If a field is prefixed with `+` it will be added to the default + fields, using `-` will remove it from the default fields. Without + prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + x-codeSamples: + - lang: Shell + label: cURL + source: + $ref: ../code_samples/Shell/store_product-tags_{id}/get.sh + tags: + - Product Tags + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: ../components/schemas/StoreProductTagResponse.yaml + '400': + $ref: ../components/responses/400_error.yaml + '401': + $ref: ../components/responses/unauthorized.yaml + '404': + $ref: ../components/responses/not_found_error.yaml + '409': + $ref: ../components/responses/invalid_state_error.yaml + '422': + $ref: ../components/responses/invalid_request_error.yaml + '500': + $ref: ../components/responses/500_error.yaml diff --git a/www/apps/api-reference/specs/store/paths/store_product-types.yaml b/www/apps/api-reference/specs/store/paths/store_product-types.yaml new file mode 100644 index 0000000000000..840c6c026dd72 --- /dev/null +++ b/www/apps/api-reference/specs/store/paths/store_product-types.yaml @@ -0,0 +1,122 @@ +get: + operationId: GetProductTypes + summary: List Product Types + description: >- + Retrieve a list of product types. The product types can be filtered by + fields such as `id`. The product types can also be sorted or paginated. + x-authenticated: false + parameters: + - name: x-publishable-api-key + in: header + description: Publishable API Key created in the Medusa Admin. + required: true + schema: + type: string + externalDocs: + url: https://docs.medusajs.com/api/store#publishable-api-key + - name: fields + in: query + description: |- + Comma-separated fields that should be included in the returned data. + * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * without prefix it will replace the entire default fields. + required: false + schema: + type: string + title: fields + description: >- + Comma-separated fields that should be included in the returned data. + If a field is prefixed with `+` it will be added to the default + fields, using `-` will remove it from the default fields. Without + prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + - name: offset + in: query + description: The number of items to skip when retrieving a list. + required: false + schema: + type: number + title: offset + description: The number of items to skip when retrieving a list. + externalDocs: + url: '#pagination' + - name: limit + in: query + description: Limit the number of items returned in the list. + required: false + schema: + type: number + title: limit + description: Limit the number of items returned in the list. + externalDocs: + url: '#pagination' + - name: order + in: query + description: >- + The field to sort the data by. By default, the sort order is ascending. + To change the order to descending, prefix the field name with `-`. + required: false + schema: + type: string + title: order + description: >- + The field to sort the data by. By default, the sort order is + ascending. To change the order to descending, prefix the field name + with `-`. + externalDocs: + url: '#pagination' + - name: $and + in: query + description: >- + Join query parameters with an AND condition. Each object's content is + the same type as the expected query parameters. + required: false + schema: + type: array + description: >- + Join query parameters with an AND condition. Each object's content is + the same type as the expected query parameters. + items: + type: object + title: $and + - name: $or + in: query + description: >- + Join query parameters with an OR condition. Each object's content is the + same type as the expected query parameters. + required: false + schema: + type: array + description: >- + Join query parameters with an OR condition. Each object's content is + the same type as the expected query parameters. + items: + type: object + title: $or + x-codeSamples: + - lang: Shell + label: cURL + source: + $ref: ../code_samples/Shell/store_product-types/get.sh + tags: + - Product Types + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: ../components/schemas/StoreProductTypeListResponse.yaml + '400': + $ref: ../components/responses/400_error.yaml + '401': + $ref: ../components/responses/unauthorized.yaml + '404': + $ref: ../components/responses/not_found_error.yaml + '409': + $ref: ../components/responses/invalid_state_error.yaml + '422': + $ref: ../components/responses/invalid_request_error.yaml + '500': + $ref: ../components/responses/500_error.yaml diff --git a/www/apps/api-reference/specs/store/paths/store_product-types_{id}.yaml b/www/apps/api-reference/specs/store/paths/store_product-types_{id}.yaml new file mode 100644 index 0000000000000..f52b902a6c08d --- /dev/null +++ b/www/apps/api-reference/specs/store/paths/store_product-types_{id}.yaml @@ -0,0 +1,65 @@ +get: + operationId: GetProductTypesId + summary: Get a Product Type + description: >- + Retrieve a product type by its ID. You can expand the product type's + relations or select the fields that should be returned. + x-authenticated: false + parameters: + - name: id + in: path + description: The product type's ID. + required: true + schema: + type: string + - name: x-publishable-api-key + in: header + description: Publishable API Key created in the Medusa Admin. + required: true + schema: + type: string + externalDocs: + url: https://docs.medusajs.com/api/store#publishable-api-key + - name: fields + in: query + description: |- + Comma-separated fields that should be included in the returned data. + * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * without prefix it will replace the entire default fields. + required: false + schema: + type: string + title: fields + description: >- + Comma-separated fields that should be included in the returned data. + If a field is prefixed with `+` it will be added to the default + fields, using `-` will remove it from the default fields. Without + prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + x-codeSamples: + - lang: Shell + label: cURL + source: + $ref: ../code_samples/Shell/store_product-types_{id}/get.sh + tags: + - Product Types + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: ../components/schemas/StoreProductTypeResponse.yaml + '400': + $ref: ../components/responses/400_error.yaml + '401': + $ref: ../components/responses/unauthorized.yaml + '404': + $ref: ../components/responses/not_found_error.yaml + '409': + $ref: ../components/responses/invalid_state_error.yaml + '422': + $ref: ../components/responses/invalid_request_error.yaml + '500': + $ref: ../components/responses/500_error.yaml diff --git a/www/utils/generated/oas-output/base/store.oas.base.yaml b/www/utils/generated/oas-output/base/store.oas.base.yaml index 8d168814caeb1..0ab8e3d1c523b 100644 --- a/www/utils/generated/oas-output/base/store.oas.base.yaml +++ b/www/utils/generated/oas-output/base/store.oas.base.yaml @@ -7,7 +7,7 @@ info: url: https://github.com/medusajs/medusa/blob/master/LICENSE tags: - name: Auth - description: > + description: | Auth API routes allow you to manage a customer's authentication. - name: Carts description: > @@ -107,6 +107,10 @@ tags: url: https://docs.medusajs.com/v2/resources/storefront-development/products/categories/list x-associatedSchema: $ref: "#/components/schemas/StoreProductCategory" + - name: Product Tags + x-associatedSchema: + $ref: "#/components/schemas/StoreProductTag" + - name: Product Types - name: Products description: > Customers browse products for their purchase. diff --git a/www/utils/generated/oas-output/operations/admin/post_admin_inventory-items_location-levels_batch.ts b/www/utils/generated/oas-output/operations/admin/post_admin_inventory-items_location-levels_batch.ts index 08381329966f4..0dbd7d794865a 100644 --- a/www/utils/generated/oas-output/operations/admin/post_admin_inventory-items_location-levels_batch.ts +++ b/www/utils/generated/oas-output/operations/admin/post_admin_inventory-items_location-levels_batch.ts @@ -12,72 +12,7 @@ * content: * application/json: * schema: - * type: object - * description: The inventory levels to manage. - * properties: - * create: - * type: array - * description: The inventory levels to create. - * items: - * type: object - * description: The details of an inventory level to create. - * required: - * - location_id - * - inventory_item_id - * properties: - * location_id: - * type: string - * title: location_id - * description: The ID of the associated stock location. - * inventory_item_id: - * type: string - * title: inventory_item_id - * description: The ID of the associated inventory item. - * stocked_quantity: - * type: number - * title: stocked_quantity - * description: The stocked quantity. - * incoming_quantity: - * type: number - * title: incoming_quantity - * description: The incoming quantity to be added to stock. - * update: - * type: array - * description: The inventory levels to update. - * items: - * type: object - * description: The details of an inventory level to update. - * required: - * - location_id - * - inventory_item_id - * properties: - * location_id: - * type: string - * title: location_id - * description: The ID of the associated stock location. - * inventory_item_id: - * type: string - * title: inventory_item_id - * description: The ID of the associated inventory item. - * stocked_quantity: - * type: number - * title: stocked_quantity - * description: The stocked quantity. - * incoming_quantity: - * type: number - * title: incoming_quantity - * description: The incoming quantity to be added to stock. - * delete: - * type: array - * description: The IDs of the inventory levels to delete. - * items: - * type: string - * title: delete - * description: The ID of the inventory level to delete. - * force: - * type: boolean - * title: force - * description: Whether to delete specified inventory levels even if they have a non-zero stocked quantity. + * $ref: "#/components/schemas/AdminBatchInventoryItemsLocationLevels" * x-codeSamples: * - lang: Shell * label: cURL @@ -109,6 +44,12 @@ * tags: * - Inventory Items * responses: + * "200": + * description: OK + * content: + * application/json: + * schema: + * $ref: "#/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse" * "400": * $ref: "#/components/responses/400_error" * "401": diff --git a/www/utils/generated/oas-output/operations/store/get_store_product-tags.ts b/www/utils/generated/oas-output/operations/store/get_store_product-tags.ts new file mode 100644 index 0000000000000..518c8316bc07b --- /dev/null +++ b/www/utils/generated/oas-output/operations/store/get_store_product-tags.ts @@ -0,0 +1,109 @@ +/** + * @oas [get] /store/product-tags + * operationId: GetProductTags + * summary: List Product Tags + * description: Retrieve a list of product tags. The product tags can be filtered by fields such as `id`. The product tags can also be sorted or paginated. + * x-authenticated: false + * parameters: + * - name: x-publishable-api-key + * in: header + * description: Publishable API Key created in the Medusa Admin. + * required: true + * schema: + * type: string + * externalDocs: + * url: https://docs.medusajs.com/api/store#publishable-api-key + * - name: fields + * in: query + * description: |- + * Comma-separated fields that should be included in the returned data. + * * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * * without prefix it will replace the entire default fields. + * required: false + * schema: + * type: string + * title: fields + * description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default + * fields. Without prefix it will replace the entire default fields. + * externalDocs: + * url: "#select-fields-and-relations" + * - name: offset + * in: query + * description: The number of items to skip when retrieving a list. + * required: false + * schema: + * type: number + * title: offset + * description: The number of items to skip when retrieving a list. + * externalDocs: + * url: "#pagination" + * - name: limit + * in: query + * description: Limit the number of items returned in the list. + * required: false + * schema: + * type: number + * title: limit + * description: Limit the number of items returned in the list. + * externalDocs: + * url: "#pagination" + * - name: order + * in: query + * description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + * required: false + * schema: + * type: string + * title: order + * description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + * externalDocs: + * url: "#pagination" + * - name: $and + * in: query + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * required: false + * schema: + * type: array + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $and + * - name: $or + * in: query + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * required: false + * schema: + * type: array + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $or + * x-codeSamples: + * - lang: Shell + * label: cURL + * source: |- + * curl '{backend_url}/store/product-tags' \ + * -H 'x-publishable-api-key: {your_publishable_api_key}' + * tags: + * - Product Tags + * responses: + * "200": + * description: OK + * content: + * application/json: + * schema: + * $ref: "#/components/schemas/StoreProductTagListResponse" + * "400": + * $ref: "#/components/responses/400_error" + * "401": + * $ref: "#/components/responses/unauthorized" + * "404": + * $ref: "#/components/responses/not_found_error" + * "409": + * $ref: "#/components/responses/invalid_state_error" + * "422": + * $ref: "#/components/responses/invalid_request_error" + * "500": + * $ref: "#/components/responses/500_error" + * +*/ + diff --git a/www/utils/generated/oas-output/operations/store/get_store_product-tags_[id].ts b/www/utils/generated/oas-output/operations/store/get_store_product-tags_[id].ts new file mode 100644 index 0000000000000..3a995bdd66f80 --- /dev/null +++ b/www/utils/generated/oas-output/operations/store/get_store_product-tags_[id].ts @@ -0,0 +1,65 @@ +/** + * @oas [get] /store/product-tags/{id} + * operationId: GetProductTagsId + * summary: Get a Product Tag + * description: Retrieve a product tag by its ID. You can expand the product tag's relations or select the fields that should be returned. + * x-authenticated: false + * parameters: + * - name: id + * in: path + * description: The product tag's ID. + * required: true + * schema: + * type: string + * - name: x-publishable-api-key + * in: header + * description: Publishable API Key created in the Medusa Admin. + * required: true + * schema: + * type: string + * externalDocs: + * url: https://docs.medusajs.com/api/store#publishable-api-key + * - name: fields + * in: query + * description: |- + * Comma-separated fields that should be included in the returned data. + * * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * * without prefix it will replace the entire default fields. + * required: false + * schema: + * type: string + * title: fields + * description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default + * fields. Without prefix it will replace the entire default fields. + * externalDocs: + * url: "#select-fields-and-relations" + * x-codeSamples: + * - lang: Shell + * label: cURL + * source: |- + * curl '{backend_url}/store/product-tags/{id}' \ + * -H 'x-publishable-api-key: {your_publishable_api_key}' + * tags: + * - Product Tags + * responses: + * "200": + * description: OK + * content: + * application/json: + * schema: + * $ref: "#/components/schemas/StoreProductTagResponse" + * "400": + * $ref: "#/components/responses/400_error" + * "401": + * $ref: "#/components/responses/unauthorized" + * "404": + * $ref: "#/components/responses/not_found_error" + * "409": + * $ref: "#/components/responses/invalid_state_error" + * "422": + * $ref: "#/components/responses/invalid_request_error" + * "500": + * $ref: "#/components/responses/500_error" + * +*/ + diff --git a/www/utils/generated/oas-output/operations/store/get_store_product-types.ts b/www/utils/generated/oas-output/operations/store/get_store_product-types.ts new file mode 100644 index 0000000000000..eb8ffb1e6ef5a --- /dev/null +++ b/www/utils/generated/oas-output/operations/store/get_store_product-types.ts @@ -0,0 +1,109 @@ +/** + * @oas [get] /store/product-types + * operationId: GetProductTypes + * summary: List Product Types + * description: Retrieve a list of product types. The product types can be filtered by fields such as `id`. The product types can also be sorted or paginated. + * x-authenticated: false + * parameters: + * - name: x-publishable-api-key + * in: header + * description: Publishable API Key created in the Medusa Admin. + * required: true + * schema: + * type: string + * externalDocs: + * url: https://docs.medusajs.com/api/store#publishable-api-key + * - name: fields + * in: query + * description: |- + * Comma-separated fields that should be included in the returned data. + * * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * * without prefix it will replace the entire default fields. + * required: false + * schema: + * type: string + * title: fields + * description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default + * fields. Without prefix it will replace the entire default fields. + * externalDocs: + * url: "#select-fields-and-relations" + * - name: offset + * in: query + * description: The number of items to skip when retrieving a list. + * required: false + * schema: + * type: number + * title: offset + * description: The number of items to skip when retrieving a list. + * externalDocs: + * url: "#pagination" + * - name: limit + * in: query + * description: Limit the number of items returned in the list. + * required: false + * schema: + * type: number + * title: limit + * description: Limit the number of items returned in the list. + * externalDocs: + * url: "#pagination" + * - name: order + * in: query + * description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + * required: false + * schema: + * type: string + * title: order + * description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + * externalDocs: + * url: "#pagination" + * - name: $and + * in: query + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * required: false + * schema: + * type: array + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $and + * - name: $or + * in: query + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * required: false + * schema: + * type: array + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $or + * x-codeSamples: + * - lang: Shell + * label: cURL + * source: |- + * curl '{backend_url}/store/product-types' \ + * -H 'x-publishable-api-key: {your_publishable_api_key}' + * tags: + * - Product Types + * responses: + * "200": + * description: OK + * content: + * application/json: + * schema: + * $ref: "#/components/schemas/StoreProductTypeListResponse" + * "400": + * $ref: "#/components/responses/400_error" + * "401": + * $ref: "#/components/responses/unauthorized" + * "404": + * $ref: "#/components/responses/not_found_error" + * "409": + * $ref: "#/components/responses/invalid_state_error" + * "422": + * $ref: "#/components/responses/invalid_request_error" + * "500": + * $ref: "#/components/responses/500_error" + * +*/ + diff --git a/www/utils/generated/oas-output/operations/store/get_store_product-types_[id].ts b/www/utils/generated/oas-output/operations/store/get_store_product-types_[id].ts new file mode 100644 index 0000000000000..226cbec788675 --- /dev/null +++ b/www/utils/generated/oas-output/operations/store/get_store_product-types_[id].ts @@ -0,0 +1,65 @@ +/** + * @oas [get] /store/product-types/{id} + * operationId: GetProductTypesId + * summary: Get a Product Type + * description: Retrieve a product type by its ID. You can expand the product type's relations or select the fields that should be returned. + * x-authenticated: false + * parameters: + * - name: id + * in: path + * description: The product type's ID. + * required: true + * schema: + * type: string + * - name: x-publishable-api-key + * in: header + * description: Publishable API Key created in the Medusa Admin. + * required: true + * schema: + * type: string + * externalDocs: + * url: https://docs.medusajs.com/api/store#publishable-api-key + * - name: fields + * in: query + * description: |- + * Comma-separated fields that should be included in the returned data. + * * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * * without prefix it will replace the entire default fields. + * required: false + * schema: + * type: string + * title: fields + * description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default + * fields. Without prefix it will replace the entire default fields. + * externalDocs: + * url: "#select-fields-and-relations" + * x-codeSamples: + * - lang: Shell + * label: cURL + * source: |- + * curl '{backend_url}/store/product-types/{id}' \ + * -H 'x-publishable-api-key: {your_publishable_api_key}' + * tags: + * - Product Types + * responses: + * "200": + * description: OK + * content: + * application/json: + * schema: + * $ref: "#/components/schemas/StoreProductTypeResponse" + * "400": + * $ref: "#/components/responses/400_error" + * "401": + * $ref: "#/components/responses/unauthorized" + * "404": + * $ref: "#/components/responses/not_found_error" + * "409": + * $ref: "#/components/responses/invalid_state_error" + * "422": + * $ref: "#/components/responses/invalid_request_error" + * "500": + * $ref: "#/components/responses/500_error" + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/AdminBatchCreateInventoryItemsLocationLevels.ts b/www/utils/generated/oas-output/schemas/AdminBatchCreateInventoryItemsLocationLevels.ts new file mode 100644 index 0000000000000..c72e1a1d8c08e --- /dev/null +++ b/www/utils/generated/oas-output/schemas/AdminBatchCreateInventoryItemsLocationLevels.ts @@ -0,0 +1,28 @@ +/** + * @schema AdminBatchCreateInventoryItemsLocationLevels + * type: object + * description: The details of an inventory level to create. + * required: + * - location_id + * - inventory_item_id + * properties: + * location_id: + * type: string + * title: location_id + * description: The ID of the associated stock location. + * inventory_item_id: + * type: string + * title: inventory_item_id + * description: The ID of the associated inventory item. + * stocked_quantity: + * type: number + * title: stocked_quantity + * description: The stocked quantity. + * incoming_quantity: + * type: number + * title: incoming_quantity + * description: The incoming quantity to be added to stock. + * x-schemaName: AdminBatchCreateInventoryItemsLocationLevels + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/AdminBatchInventoryItemsLocationLevels.ts b/www/utils/generated/oas-output/schemas/AdminBatchInventoryItemsLocationLevels.ts new file mode 100644 index 0000000000000..643118c84a8f3 --- /dev/null +++ b/www/utils/generated/oas-output/schemas/AdminBatchInventoryItemsLocationLevels.ts @@ -0,0 +1,34 @@ +/** + * @schema AdminBatchInventoryItemsLocationLevels + * type: object + * description: The inventory levels to manage. + * properties: + * create: + * type: array + * description: The inventory levels to create. + * items: + * $ref: "#/components/schemas/AdminBatchCreateInventoryItemsLocationLevels" + * update: + * type: array + * description: The inventory levels to update. + * items: + * $ref: "#/components/schemas/AdminBatchUpdateInventoryItemsLocationLevels" + * delete: + * type: array + * description: The IDs of the inventory levels to delete. + * items: + * type: string + * title: delete + * description: The ID of the inventory level to delete. + * force: + * type: boolean + * title: force + * description: Whether to delete specified inventory levels even if they have a non-zero stocked quantity. + * required: + * - create + * - update + * - delete + * x-schemaName: AdminBatchInventoryItemsLocationLevels + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/AdminBatchInventoryItemsLocationLevelsResponse.ts b/www/utils/generated/oas-output/schemas/AdminBatchInventoryItemsLocationLevelsResponse.ts new file mode 100644 index 0000000000000..292b2a1661133 --- /dev/null +++ b/www/utils/generated/oas-output/schemas/AdminBatchInventoryItemsLocationLevelsResponse.ts @@ -0,0 +1,26 @@ +/** + * @schema AdminBatchInventoryItemsLocationLevelsResponse + * type: object + * description: SUMMARY + * x-schemaName: AdminBatchInventoryItemsLocationLevelsResponse + * properties: + * created: + * type: array + * description: The inventory item's created. + * items: + * $ref: "#/components/schemas/InventoryLevel" + * updated: + * type: array + * description: The inventory item's updated. + * items: + * $ref: "#/components/schemas/InventoryLevel" + * deleted: + * type: array + * description: SUMMARY + * items: + * type: string + * title: deleted + * description: SUMMARY + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/AdminBatchUpdateInventoryItemsLocationLevels.ts b/www/utils/generated/oas-output/schemas/AdminBatchUpdateInventoryItemsLocationLevels.ts new file mode 100644 index 0000000000000..9b49d0be14df1 --- /dev/null +++ b/www/utils/generated/oas-output/schemas/AdminBatchUpdateInventoryItemsLocationLevels.ts @@ -0,0 +1,32 @@ +/** + * @schema AdminBatchUpdateInventoryItemsLocationLevels + * type: object + * description: The details of an inventory level to update. + * required: + * - location_id + * - inventory_item_id + * properties: + * location_id: + * type: string + * title: location_id + * description: The ID of the associated stock location. + * inventory_item_id: + * type: string + * title: inventory_item_id + * description: The ID of the associated inventory item. + * stocked_quantity: + * type: number + * title: stocked_quantity + * description: The stocked quantity. + * incoming_quantity: + * type: number + * title: incoming_quantity + * description: The incoming quantity to be added to stock. + * id: + * type: string + * title: id + * description: The update's ID. + * x-schemaName: AdminBatchUpdateInventoryItemsLocationLevels + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/AdminShippingOptionRule.ts b/www/utils/generated/oas-output/schemas/AdminShippingOptionRule.ts index a65354d80a6e6..5401833495f39 100644 --- a/www/utils/generated/oas-output/schemas/AdminShippingOptionRule.ts +++ b/www/utils/generated/oas-output/schemas/AdminShippingOptionRule.ts @@ -1,7 +1,7 @@ /** * @schema AdminShippingOptionRule * type: object - * description: The shipping option rule's details. + * description: The rule's rules. * x-schemaName: AdminShippingOptionRule * required: * - id @@ -16,38 +16,53 @@ * id: * type: string * title: id - * description: The shipping option rule's ID. + * description: The rule's ID. * attribute: * type: string * title: attribute - * description: The shipping option rule's attribute. - * example: is_return + * description: The rule's attribute. * operator: * type: string - * title: operator - * description: The shipping option rule's operator. - * example: eq + * description: The rule's operator. + * enum: + * - gt + * - lt + * - eq + * - ne + * - in + * - lte + * - gte + * - nin * value: - * type: string - * title: value + * oneOf: + * - type: string + * title: value + * description: The rule's value. + * - type: array + * description: The rule's value. + * items: + * type: string + * title: value + * description: The value's details. * shipping_option_id: * type: string * title: shipping_option_id - * description: The ID of the shipping option this rule is for. + * description: The rule's shipping option id. * created_at: * type: string * format: date-time * title: created_at - * description: The date the shipping option rule was created. + * description: The rule's created at. * updated_at: * type: string * format: date-time * title: updated_at - * description: The date the shipping option rule was updated. + * description: The rule's updated at. * deleted_at: * type: string * format: date-time * title: deleted_at - * description: The date the shipping option rule was deleted. - * - */ + * description: The rule's deleted at. + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/InventoryLevel.ts b/www/utils/generated/oas-output/schemas/InventoryLevel.ts index 2f537ca249eba..5027840dbf1d4 100644 --- a/www/utils/generated/oas-output/schemas/InventoryLevel.ts +++ b/www/utils/generated/oas-output/schemas/InventoryLevel.ts @@ -1,7 +1,7 @@ /** * @schema InventoryLevel * type: object - * description: The inventory level's details + * description: The created's details. * x-schemaName: InventoryLevel * required: * - id @@ -15,34 +15,34 @@ * id: * type: string * title: id - * description: The inventory level's ID. + * description: The created's ID. * inventory_item_id: * type: string * title: inventory_item_id - * description: The ID of the associated inventory item. + * description: The created's inventory item id. * location_id: * type: string * title: location_id - * description: The ID of the associated location. + * description: The created's location id. * stocked_quantity: * type: number * title: stocked_quantity - * description: The inventory level's stocked quantity. + * description: The created's stocked quantity. * reserved_quantity: * type: number * title: reserved_quantity - * description: The inventory level's reserved quantity. + * description: The created's reserved quantity. * available_quantity: * type: number * title: available_quantity - * description: The inventory level's available quantity. + * description: The created's available quantity. * incoming_quantity: * type: number * title: incoming_quantity - * description: The inventory level's incoming quantity. + * description: The created's incoming quantity. * metadata: * type: object - * description: The inventory level's metadata, can hold custom key-value pairs. + * description: The created's metadata. * */ diff --git a/www/utils/generated/oas-output/schemas/StoreProductTagListResponse.ts b/www/utils/generated/oas-output/schemas/StoreProductTagListResponse.ts new file mode 100644 index 0000000000000..efd638e0555ec --- /dev/null +++ b/www/utils/generated/oas-output/schemas/StoreProductTagListResponse.ts @@ -0,0 +1,31 @@ +/** + * @schema StoreProductTagListResponse + * type: object + * description: SUMMARY + * x-schemaName: StoreProductTagListResponse + * required: + * - limit + * - offset + * - count + * - product_tags + * properties: + * limit: + * type: number + * title: limit + * description: The product tag's limit. + * offset: + * type: number + * title: offset + * description: The product tag's offset. + * count: + * type: number + * title: count + * description: The product tag's count. + * product_tags: + * type: array + * description: The product tag's product tags. + * items: + * $ref: "#/components/schemas/StoreProductTag" + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/StoreProductTagResponse.ts b/www/utils/generated/oas-output/schemas/StoreProductTagResponse.ts new file mode 100644 index 0000000000000..c5472b2e56258 --- /dev/null +++ b/www/utils/generated/oas-output/schemas/StoreProductTagResponse.ts @@ -0,0 +1,13 @@ +/** + * @schema StoreProductTagResponse + * type: object + * description: SUMMARY + * x-schemaName: StoreProductTagResponse + * required: + * - product_tag + * properties: + * product_tag: + * $ref: "#/components/schemas/StoreProductTag" + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/StoreProductTypeListResponse.ts b/www/utils/generated/oas-output/schemas/StoreProductTypeListResponse.ts new file mode 100644 index 0000000000000..4d29bb2f035b3 --- /dev/null +++ b/www/utils/generated/oas-output/schemas/StoreProductTypeListResponse.ts @@ -0,0 +1,31 @@ +/** + * @schema StoreProductTypeListResponse + * type: object + * description: SUMMARY + * x-schemaName: StoreProductTypeListResponse + * required: + * - limit + * - offset + * - count + * - product_types + * properties: + * limit: + * type: number + * title: limit + * description: The product type's limit. + * offset: + * type: number + * title: offset + * description: The product type's offset. + * count: + * type: number + * title: count + * description: The product type's count. + * product_types: + * type: array + * description: The product type's product types. + * items: + * $ref: "#/components/schemas/StoreProduct" + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/StoreProductTypeResponse.ts b/www/utils/generated/oas-output/schemas/StoreProductTypeResponse.ts new file mode 100644 index 0000000000000..9ff0fa37d3308 --- /dev/null +++ b/www/utils/generated/oas-output/schemas/StoreProductTypeResponse.ts @@ -0,0 +1,13 @@ +/** + * @schema StoreProductTypeResponse + * type: object + * description: SUMMARY + * x-schemaName: StoreProductTypeResponse + * required: + * - product_type + * properties: + * product_type: + * $ref: "#/components/schemas/StoreProduct" + * +*/ + From a60b67e6162c0c17339708dcfe4695c1bc6cf247 Mon Sep 17 00:00:00 2001 From: Shahed Nasser Date: Mon, 27 Jan 2025 13:30:16 +0200 Subject: [PATCH 2/2] updates --- ...hInventoryItemsLocationLevelsResponse.yaml | 10 +- .../schemas/AdminShippingOptionRule.yaml | 27 +- .../components/schemas/InventoryLevel.yaml | 18 +- .../schemas/StoreProductTagListResponse.yaml | 10 +- .../schemas/StoreProductTagResponse.yaml | 2 +- .../schemas/StoreProductTypeListResponse.yaml | 10 +- .../schemas/StoreProductTypeResponse.yaml | 2 +- .../specs/admin/openapi.full.yaml | 79 +- ...hInventoryItemsLocationLevelsResponse.yaml | 10 +- .../schemas/AdminShippingOptionRule.yaml | 27 +- .../components/schemas/InventoryLevel.yaml | 18 +- .../schemas/StoreProductTagListResponse.yaml | 10 +- .../schemas/StoreProductTagResponse.yaml | 2 +- .../schemas/StoreProductTypeListResponse.yaml | 10 +- .../schemas/StoreProductTypeResponse.yaml | 2 +- .../specs/store/openapi.full.yaml | 1383 ++++++++++++++--- .../specs/store/paths/store_product-tags.yaml | 583 ++++++- .../store/paths/store_product-tags_{id}.yaml | 9 +- .../store/paths/store_product-types.yaml | 578 ++++++- .../store/paths/store_product-types_{id}.yaml | 4 +- .../store/get_store_product-tags.ts | 502 +++++- .../store/get_store_product-tags_[id].ts | 4 +- .../store/get_store_product-types.ts | 502 +++++- .../store/get_store_product-types_[id].ts | 4 +- ...tchInventoryItemsLocationLevelsResponse.ts | 10 +- .../schemas/AdminShippingOptionRule.ts | 32 +- .../oas-output/schemas/InventoryLevel.ts | 18 +- .../schemas/StoreProductTagListResponse.ts | 10 +- .../schemas/StoreProductTagResponse.ts | 2 +- .../schemas/StoreProductTypeListResponse.ts | 10 +- .../schemas/StoreProductTypeResponse.ts | 2 +- 31 files changed, 3500 insertions(+), 390 deletions(-) diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml index b6a778681e90e..f65ff69002b20 100644 --- a/www/apps/api-reference/specs/admin/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml @@ -1,21 +1,21 @@ type: object -description: SUMMARY +description: The result of managing inventory levels. x-schemaName: AdminBatchInventoryItemsLocationLevelsResponse properties: created: type: array - description: The inventory item's created. + description: The created inventory levels. items: $ref: ./InventoryLevel.yaml updated: type: array - description: The inventory item's updated. + description: The updated inventory levels. items: $ref: ./InventoryLevel.yaml deleted: type: array - description: SUMMARY + description: The IDs of deleted inventory levels. items: type: string title: deleted - description: SUMMARY + description: The ID of a deleted inventory level. diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminShippingOptionRule.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminShippingOptionRule.yaml index 5161a04d59a16..2676706b8ee9d 100644 --- a/www/apps/api-reference/specs/admin/components/schemas/AdminShippingOptionRule.yaml +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminShippingOptionRule.yaml @@ -1,5 +1,5 @@ type: object -description: The rule's rules. +description: The shipping option rule's details. x-schemaName: AdminShippingOptionRule required: - id @@ -14,11 +14,12 @@ properties: id: type: string title: id - description: The rule's ID. + description: The shipping option rule's ID. attribute: type: string title: attribute - description: The rule's attribute. + description: The shipping option rule's attribute. + example: is_return operator: type: string description: The rule's operator. @@ -32,32 +33,24 @@ properties: - gte - nin value: - oneOf: - - type: string - title: value - description: The rule's value. - - type: array - description: The rule's value. - items: - type: string - title: value - description: The value's details. + type: string + title: value shipping_option_id: type: string title: shipping_option_id - description: The rule's shipping option id. + description: The ID of the shipping option this rule is for. created_at: type: string format: date-time title: created_at - description: The rule's created at. + description: The date the shipping option rule was created. updated_at: type: string format: date-time title: updated_at - description: The rule's updated at. + description: The date the shipping option rule was updated. deleted_at: type: string format: date-time title: deleted_at - description: The rule's deleted at. + description: The date the shipping option rule was deleted. diff --git a/www/apps/api-reference/specs/admin/components/schemas/InventoryLevel.yaml b/www/apps/api-reference/specs/admin/components/schemas/InventoryLevel.yaml index 658993eeab942..aa13bb7243bb5 100644 --- a/www/apps/api-reference/specs/admin/components/schemas/InventoryLevel.yaml +++ b/www/apps/api-reference/specs/admin/components/schemas/InventoryLevel.yaml @@ -1,5 +1,5 @@ type: object -description: The created's details. +description: The inventory level's details x-schemaName: InventoryLevel required: - id @@ -13,31 +13,31 @@ properties: id: type: string title: id - description: The created's ID. + description: The inventory level's ID. inventory_item_id: type: string title: inventory_item_id - description: The created's inventory item id. + description: The ID of the associated inventory item. location_id: type: string title: location_id - description: The created's location id. + description: The ID of the associated location. stocked_quantity: type: number title: stocked_quantity - description: The created's stocked quantity. + description: The inventory level's stocked quantity. reserved_quantity: type: number title: reserved_quantity - description: The created's reserved quantity. + description: The inventory level's reserved quantity. available_quantity: type: number title: available_quantity - description: The created's available quantity. + description: The inventory level's available quantity. incoming_quantity: type: number title: incoming_quantity - description: The created's incoming quantity. + description: The inventory level's incoming quantity. metadata: type: object - description: The created's metadata. + description: The inventory level's metadata, can hold custom key-value pairs. diff --git a/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagListResponse.yaml b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagListResponse.yaml index db5aee4f3a4d2..3dc71d398d8bd 100644 --- a/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagListResponse.yaml +++ b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagListResponse.yaml @@ -1,5 +1,5 @@ type: object -description: SUMMARY +description: The paginated list of product tags. x-schemaName: StoreProductTagListResponse required: - limit @@ -10,17 +10,17 @@ properties: limit: type: number title: limit - description: The product tag's limit. + description: The maximum number of items returned. offset: type: number title: offset - description: The product tag's offset. + description: The number of items to skip before retrieving the returned items. count: type: number title: count - description: The product tag's count. + description: The total number of items available. product_tags: type: array - description: The product tag's product tags. + description: The list of product tags. items: $ref: ./StoreProductTag.yaml diff --git a/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagResponse.yaml b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagResponse.yaml index 204949ffce4b8..ddb6b7c16f98a 100644 --- a/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagResponse.yaml +++ b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTagResponse.yaml @@ -1,5 +1,5 @@ type: object -description: SUMMARY +description: The product tag's details. x-schemaName: StoreProductTagResponse required: - product_tag diff --git a/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeListResponse.yaml b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeListResponse.yaml index ad23d10f1b932..5759dba22637e 100644 --- a/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeListResponse.yaml +++ b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeListResponse.yaml @@ -1,5 +1,5 @@ type: object -description: SUMMARY +description: The paginated list of product types. x-schemaName: StoreProductTypeListResponse required: - limit @@ -10,17 +10,17 @@ properties: limit: type: number title: limit - description: The product type's limit. + description: The maximum number of items returned. offset: type: number title: offset - description: The product type's offset. + description: The number of items to skip before retrieving the returned items. count: type: number title: count - description: The product type's count. + description: The total number of items available. product_types: type: array - description: The product type's product types. + description: The list of product types. items: $ref: ./StoreProduct.yaml diff --git a/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeResponse.yaml b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeResponse.yaml index 3952e4b2b660d..329c131c1dc99 100644 --- a/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeResponse.yaml +++ b/www/apps/api-reference/specs/admin/components/schemas/StoreProductTypeResponse.yaml @@ -1,5 +1,5 @@ type: object -description: SUMMARY +description: The product type's details. x-schemaName: StoreProductTypeResponse required: - product_type diff --git a/www/apps/api-reference/specs/admin/openapi.full.yaml b/www/apps/api-reference/specs/admin/openapi.full.yaml index 3988d4915307e..4cf2c1a5882d6 100644 --- a/www/apps/api-reference/specs/admin/openapi.full.yaml +++ b/www/apps/api-reference/specs/admin/openapi.full.yaml @@ -43878,26 +43878,26 @@ components: x-schemaName: AdminBatchInventoryItemsLocationLevels AdminBatchInventoryItemsLocationLevelsResponse: type: object - description: SUMMARY + description: The result of managing inventory levels. x-schemaName: AdminBatchInventoryItemsLocationLevelsResponse properties: created: type: array - description: The inventory item's created. + description: The created inventory levels. items: $ref: '#/components/schemas/InventoryLevel' updated: type: array - description: The inventory item's updated. + description: The updated inventory levels. items: $ref: '#/components/schemas/InventoryLevel' deleted: type: array - description: SUMMARY + description: The IDs of deleted inventory levels. items: type: string title: deleted - description: SUMMARY + description: The ID of a deleted inventory level. AdminBatchProductRequest: type: object description: The products to create, update, or delete. @@ -53304,7 +53304,7 @@ components: $ref: '#/components/schemas/AdminShippingOption' AdminShippingOptionRule: type: object - description: The rule's rules. + description: The shipping option rule's details. x-schemaName: AdminShippingOptionRule required: - id @@ -53319,11 +53319,12 @@ components: id: type: string title: id - description: The rule's ID. + description: The shipping option rule's ID. attribute: type: string title: attribute - description: The rule's attribute. + description: The shipping option rule's attribute. + example: is_return operator: type: string description: The rule's operator. @@ -53337,35 +53338,27 @@ components: - gte - nin value: - oneOf: - - type: string - title: value - description: The rule's value. - - type: array - description: The rule's value. - items: - type: string - title: value - description: The value's details. + type: string + title: value shipping_option_id: type: string title: shipping_option_id - description: The rule's shipping option id. + description: The ID of the shipping option this rule is for. created_at: type: string format: date-time title: created_at - description: The rule's created at. + description: The date the shipping option rule was created. updated_at: type: string format: date-time title: updated_at - description: The rule's updated at. + description: The date the shipping option rule was updated. deleted_at: type: string format: date-time title: deleted_at - description: The rule's deleted at. + description: The date the shipping option rule was deleted. AdminShippingOptionType: type: object description: The shipping option's details. @@ -58933,7 +58926,7 @@ components: - unknown_error InventoryLevel: type: object - description: The created's details. + description: The inventory level's details x-schemaName: InventoryLevel required: - id @@ -58947,34 +58940,34 @@ components: id: type: string title: id - description: The created's ID. + description: The inventory level's ID. inventory_item_id: type: string title: inventory_item_id - description: The created's inventory item id. + description: The ID of the associated inventory item. location_id: type: string title: location_id - description: The created's location id. + description: The ID of the associated location. stocked_quantity: type: number title: stocked_quantity - description: The created's stocked quantity. + description: The inventory level's stocked quantity. reserved_quantity: type: number title: reserved_quantity - description: The created's reserved quantity. + description: The inventory level's reserved quantity. available_quantity: type: number title: available_quantity - description: The created's available quantity. + description: The inventory level's available quantity. incoming_quantity: type: number title: incoming_quantity - description: The created's incoming quantity. + description: The inventory level's incoming quantity. metadata: type: object - description: The created's metadata. + description: The inventory level's metadata, can hold custom key-value pairs. Order: type: object description: The order change's order. @@ -69089,7 +69082,7 @@ components: - updated_at StoreProductTagListResponse: type: object - description: SUMMARY + description: The paginated list of product tags. x-schemaName: StoreProductTagListResponse required: - limit @@ -69100,23 +69093,23 @@ components: limit: type: number title: limit - description: The product tag's limit. + description: The maximum number of items returned. offset: type: number title: offset - description: The product tag's offset. + description: The number of items to skip before retrieving the returned items. count: type: number title: count - description: The product tag's count. + description: The total number of items available. product_tags: type: array - description: The product tag's product tags. + description: The list of product tags. items: $ref: '#/components/schemas/StoreProductTag' StoreProductTagResponse: type: object - description: SUMMARY + description: The product tag's details. x-schemaName: StoreProductTagResponse required: - product_tag @@ -69125,7 +69118,7 @@ components: $ref: '#/components/schemas/StoreProductTag' StoreProductTypeListResponse: type: object - description: SUMMARY + description: The paginated list of product types. x-schemaName: StoreProductTypeListResponse required: - limit @@ -69136,23 +69129,23 @@ components: limit: type: number title: limit - description: The product type's limit. + description: The maximum number of items returned. offset: type: number title: offset - description: The product type's offset. + description: The number of items to skip before retrieving the returned items. count: type: number title: count - description: The product type's count. + description: The total number of items available. product_types: type: array - description: The product type's product types. + description: The list of product types. items: $ref: '#/components/schemas/StoreProduct' StoreProductTypeResponse: type: object - description: SUMMARY + description: The product type's details. x-schemaName: StoreProductTypeResponse required: - product_type diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml index b6a778681e90e..f65ff69002b20 100644 --- a/www/apps/api-reference/specs/store/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml +++ b/www/apps/api-reference/specs/store/components/schemas/AdminBatchInventoryItemsLocationLevelsResponse.yaml @@ -1,21 +1,21 @@ type: object -description: SUMMARY +description: The result of managing inventory levels. x-schemaName: AdminBatchInventoryItemsLocationLevelsResponse properties: created: type: array - description: The inventory item's created. + description: The created inventory levels. items: $ref: ./InventoryLevel.yaml updated: type: array - description: The inventory item's updated. + description: The updated inventory levels. items: $ref: ./InventoryLevel.yaml deleted: type: array - description: SUMMARY + description: The IDs of deleted inventory levels. items: type: string title: deleted - description: SUMMARY + description: The ID of a deleted inventory level. diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminShippingOptionRule.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminShippingOptionRule.yaml index 5161a04d59a16..2676706b8ee9d 100644 --- a/www/apps/api-reference/specs/store/components/schemas/AdminShippingOptionRule.yaml +++ b/www/apps/api-reference/specs/store/components/schemas/AdminShippingOptionRule.yaml @@ -1,5 +1,5 @@ type: object -description: The rule's rules. +description: The shipping option rule's details. x-schemaName: AdminShippingOptionRule required: - id @@ -14,11 +14,12 @@ properties: id: type: string title: id - description: The rule's ID. + description: The shipping option rule's ID. attribute: type: string title: attribute - description: The rule's attribute. + description: The shipping option rule's attribute. + example: is_return operator: type: string description: The rule's operator. @@ -32,32 +33,24 @@ properties: - gte - nin value: - oneOf: - - type: string - title: value - description: The rule's value. - - type: array - description: The rule's value. - items: - type: string - title: value - description: The value's details. + type: string + title: value shipping_option_id: type: string title: shipping_option_id - description: The rule's shipping option id. + description: The ID of the shipping option this rule is for. created_at: type: string format: date-time title: created_at - description: The rule's created at. + description: The date the shipping option rule was created. updated_at: type: string format: date-time title: updated_at - description: The rule's updated at. + description: The date the shipping option rule was updated. deleted_at: type: string format: date-time title: deleted_at - description: The rule's deleted at. + description: The date the shipping option rule was deleted. diff --git a/www/apps/api-reference/specs/store/components/schemas/InventoryLevel.yaml b/www/apps/api-reference/specs/store/components/schemas/InventoryLevel.yaml index 658993eeab942..aa13bb7243bb5 100644 --- a/www/apps/api-reference/specs/store/components/schemas/InventoryLevel.yaml +++ b/www/apps/api-reference/specs/store/components/schemas/InventoryLevel.yaml @@ -1,5 +1,5 @@ type: object -description: The created's details. +description: The inventory level's details x-schemaName: InventoryLevel required: - id @@ -13,31 +13,31 @@ properties: id: type: string title: id - description: The created's ID. + description: The inventory level's ID. inventory_item_id: type: string title: inventory_item_id - description: The created's inventory item id. + description: The ID of the associated inventory item. location_id: type: string title: location_id - description: The created's location id. + description: The ID of the associated location. stocked_quantity: type: number title: stocked_quantity - description: The created's stocked quantity. + description: The inventory level's stocked quantity. reserved_quantity: type: number title: reserved_quantity - description: The created's reserved quantity. + description: The inventory level's reserved quantity. available_quantity: type: number title: available_quantity - description: The created's available quantity. + description: The inventory level's available quantity. incoming_quantity: type: number title: incoming_quantity - description: The created's incoming quantity. + description: The inventory level's incoming quantity. metadata: type: object - description: The created's metadata. + description: The inventory level's metadata, can hold custom key-value pairs. diff --git a/www/apps/api-reference/specs/store/components/schemas/StoreProductTagListResponse.yaml b/www/apps/api-reference/specs/store/components/schemas/StoreProductTagListResponse.yaml index db5aee4f3a4d2..3dc71d398d8bd 100644 --- a/www/apps/api-reference/specs/store/components/schemas/StoreProductTagListResponse.yaml +++ b/www/apps/api-reference/specs/store/components/schemas/StoreProductTagListResponse.yaml @@ -1,5 +1,5 @@ type: object -description: SUMMARY +description: The paginated list of product tags. x-schemaName: StoreProductTagListResponse required: - limit @@ -10,17 +10,17 @@ properties: limit: type: number title: limit - description: The product tag's limit. + description: The maximum number of items returned. offset: type: number title: offset - description: The product tag's offset. + description: The number of items to skip before retrieving the returned items. count: type: number title: count - description: The product tag's count. + description: The total number of items available. product_tags: type: array - description: The product tag's product tags. + description: The list of product tags. items: $ref: ./StoreProductTag.yaml diff --git a/www/apps/api-reference/specs/store/components/schemas/StoreProductTagResponse.yaml b/www/apps/api-reference/specs/store/components/schemas/StoreProductTagResponse.yaml index 204949ffce4b8..ddb6b7c16f98a 100644 --- a/www/apps/api-reference/specs/store/components/schemas/StoreProductTagResponse.yaml +++ b/www/apps/api-reference/specs/store/components/schemas/StoreProductTagResponse.yaml @@ -1,5 +1,5 @@ type: object -description: SUMMARY +description: The product tag's details. x-schemaName: StoreProductTagResponse required: - product_tag diff --git a/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeListResponse.yaml b/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeListResponse.yaml index ad23d10f1b932..5759dba22637e 100644 --- a/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeListResponse.yaml +++ b/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeListResponse.yaml @@ -1,5 +1,5 @@ type: object -description: SUMMARY +description: The paginated list of product types. x-schemaName: StoreProductTypeListResponse required: - limit @@ -10,17 +10,17 @@ properties: limit: type: number title: limit - description: The product type's limit. + description: The maximum number of items returned. offset: type: number title: offset - description: The product type's offset. + description: The number of items to skip before retrieving the returned items. count: type: number title: count - description: The product type's count. + description: The total number of items available. product_types: type: array - description: The product type's product types. + description: The list of product types. items: $ref: ./StoreProduct.yaml diff --git a/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeResponse.yaml b/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeResponse.yaml index 3952e4b2b660d..329c131c1dc99 100644 --- a/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeResponse.yaml +++ b/www/apps/api-reference/specs/store/components/schemas/StoreProductTypeResponse.yaml @@ -1,5 +1,5 @@ type: object -description: SUMMARY +description: The product type's details. x-schemaName: StoreProductTypeResponse required: - product_type diff --git a/www/apps/api-reference/specs/store/openapi.full.yaml b/www/apps/api-reference/specs/store/openapi.full.yaml index bbcfb9302a6b0..e5a772d25ce6b 100644 --- a/www/apps/api-reference/specs/store/openapi.full.yaml +++ b/www/apps/api-reference/specs/store/openapi.full.yaml @@ -4654,8 +4654,8 @@ paths: in: query description: |- Comma-separated fields that should be included in the returned data. - * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. - * without prefix it will replace the entire default fields. + if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + without prefix it will replace the entire default fields. required: false schema: type: string @@ -4713,172 +4713,1168 @@ paths: items: type: object title: $or - x-codeSamples: - - lang: Shell - label: cURL - source: |- - curl '{backend_url}/store/product-tags' \ - -H 'x-publishable-api-key: {your_publishable_api_key}' - tags: - - Product Tags - responses: - '200': - description: OK - content: - application/json: - schema: - $ref: '#/components/schemas/StoreProductTagListResponse' - '400': - $ref: '#/components/responses/400_error' - '401': - $ref: '#/components/responses/unauthorized' - '404': - $ref: '#/components/responses/not_found_error' - '409': - $ref: '#/components/responses/invalid_state_error' - '422': - $ref: '#/components/responses/invalid_request_error' - '500': - $ref: '#/components/responses/500_error' - /store/product-tags/{id}: - get: - operationId: GetProductTagsId - summary: Get a Product Tag - description: Retrieve a product tag by its ID. You can expand the product tag's relations or select the fields that should be returned. - x-authenticated: false - parameters: - - name: id - in: path - description: The product tag's ID. - required: true - schema: - type: string - - name: x-publishable-api-key - in: header - description: Publishable API Key created in the Medusa Admin. - required: true - schema: - type: string - externalDocs: - url: https://docs.medusajs.com/api/store#publishable-api-key - - name: fields - in: query - description: |- - Comma-separated fields that should be included in the returned data. - * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. - * without prefix it will replace the entire default fields. - required: false - schema: - type: string - title: fields - description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. - externalDocs: - url: '#select-fields-and-relations' - x-codeSamples: - - lang: Shell - label: cURL - source: |- - curl '{backend_url}/store/product-tags/{id}' \ - -H 'x-publishable-api-key: {your_publishable_api_key}' - tags: - - Product Tags - responses: - '200': - description: OK - content: - application/json: - schema: - $ref: '#/components/schemas/StoreProductTagResponse' - '400': - $ref: '#/components/responses/400_error' - '401': - $ref: '#/components/responses/unauthorized' - '404': - $ref: '#/components/responses/not_found_error' - '409': - $ref: '#/components/responses/invalid_state_error' - '422': - $ref: '#/components/responses/invalid_request_error' - '500': - $ref: '#/components/responses/500_error' - /store/product-types: - get: - operationId: GetProductTypes - summary: List Product Types - description: Retrieve a list of product types. The product types can be filtered by fields such as `id`. The product types can also be sorted or paginated. - x-authenticated: false - parameters: - - name: x-publishable-api-key - in: header - description: Publishable API Key created in the Medusa Admin. - required: true - schema: - type: string - externalDocs: - url: https://docs.medusajs.com/api/store#publishable-api-key - - name: fields + - name: q in: query - description: |- - Comma-separated fields that should be included in the returned data. - * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. - * without prefix it will replace the entire default fields. + description: Query to search product tag's searchable fields. required: false schema: type: string - title: fields - description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. - externalDocs: - url: '#select-fields-and-relations' - - name: offset - in: query - description: The number of items to skip when retrieving a list. - required: false - schema: - type: number - title: offset - description: The number of items to skip when retrieving a list. - externalDocs: - url: '#pagination' - - name: limit + title: q + description: Query to search product tag's searchable fields. + - name: id in: query - description: Limit the number of items returned in the list. required: false schema: - type: number - title: limit - description: Limit the number of items returned in the list. - externalDocs: - url: '#pagination' - - name: order + oneOf: + - type: string + title: id + description: Filter by a product tag's ID. + - type: array + description: Filter by product tag IDs. + items: + type: string + title: id + description: A product tag's ID. + - name: value in: query - description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. required: false schema: - type: string - title: order - description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. - externalDocs: - url: '#pagination' - - name: $and + oneOf: + - type: string + title: value + description: Filter by a product tag's value. + - type: array + description: Filter by product tag values. + items: + type: string + title: value + description: A product tag's value. + - name: created_at in: query - description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + description: Filter by the tag's creation date. required: false schema: - type: array - description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. - items: - type: object - title: $and - - name: $or + type: object + description: Filter by the tag's creation date. + properties: + $and: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: An exact match. + $ne: + type: string + title: $ne + description: Filter by values not equal to this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value not to match. + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter. + - type: object + description: Filter by values not matching the conditions in this parameter. + properties: + $and: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: The value to match. + $ne: + type: string + title: $ne + description: Filter by values not matching this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value to not match + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter + - type: object + description: Filter by values not matching the conditions in this parameter. + - type: array + description: Filter by values not matching the values of this parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: Filter by values greater than this parameter. Useful for numbers and dates only. + $gte: + type: string + title: $gte + description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: Filter by values less than this parameter. Useful for numbers and dates only. + $lte: + type: string + title: $lte + description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: The value to match. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). + - type: array + description: Filter by values not matching those in this parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: Filter by values greater than this parameter. Useful for numbers and dates only. + $gte: + type: string + title: $gte + description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: Filter by values less than this parameter. Useful for numbers and dates only. + $lte: + type: string + title: $lte + description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: The values to match. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). + - name: updated_at + in: query + description: Filter by the tag's update date. + required: false + schema: + type: object + description: Filter by the tag's update date. + properties: + $and: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: An exact match. + $ne: + type: string + title: $ne + description: Filter by values not equal to this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value not to match. + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter. + - type: object + description: Filter by values not matching the conditions in this parameter. + properties: + $and: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: The value to match. + $ne: + type: string + title: $ne + description: Filter by values not matching this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value to not match + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter + - type: object + description: Filter by values not matching the conditions in this parameter. + - type: array + description: Filter by values not matching the values of this parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: Filter by values greater than this parameter. Useful for numbers and dates only. + $gte: + type: string + title: $gte + description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: Filter by values less than this parameter. Useful for numbers and dates only. + $lte: + type: string + title: $lte + description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: The value to match. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). + - type: array + description: Filter by values not matching those in this parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: Filter by values greater than this parameter. Useful for numbers and dates only. + $gte: + type: string + title: $gte + description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: Filter by values less than this parameter. Useful for numbers and dates only. + $lte: + type: string + title: $lte + description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: The values to match. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl '{backend_url}/store/product-tags' \ + -H 'x-publishable-api-key: {your_publishable_api_key}' + tags: + - Product Tags + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/StoreProductTagListResponse' + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' + /store/product-tags/{id}: + get: + operationId: GetProductTagsId + summary: Get a Product Tag + description: Retrieve a product tag by its ID. You can expand the product tag's relations or select the fields that should be returned. + x-authenticated: false + parameters: + - name: id + in: path + description: The product tag's ID. + required: true + schema: + type: string + - name: x-publishable-api-key + in: header + description: Publishable API Key created in the Medusa Admin. + required: true + schema: + type: string + externalDocs: + url: https://docs.medusajs.com/api/store#publishable-api-key + - name: fields + in: query + description: |- + Comma-separated fields that should be included in the returned data. + if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + without prefix it will replace the entire default fields. + required: false + schema: + type: string + title: fields + description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl '{backend_url}/store/product-tags/{id}' \ + -H 'x-publishable-api-key: {your_publishable_api_key}' + tags: + - Product Tags + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/StoreProductTagResponse' + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' + /store/product-types: + get: + operationId: GetProductTypes + summary: List Product Types + description: Retrieve a list of product types. The product types can be filtered by fields such as `id`. The product types can also be sorted or paginated. + x-authenticated: false + parameters: + - name: x-publishable-api-key + in: header + description: Publishable API Key created in the Medusa Admin. + required: true + schema: + type: string + externalDocs: + url: https://docs.medusajs.com/api/store#publishable-api-key + - name: fields + in: query + description: |- + Comma-separated fields that should be included in the returned data. + if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + without prefix it will replace the entire default fields. + required: false + schema: + type: string + title: fields + description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + - name: offset + in: query + description: The number of items to skip when retrieving a list. + required: false + schema: + type: number + title: offset + description: The number of items to skip when retrieving a list. + externalDocs: + url: '#pagination' + - name: limit + in: query + description: Limit the number of items returned in the list. + required: false + schema: + type: number + title: limit + description: Limit the number of items returned in the list. + externalDocs: + url: '#pagination' + - name: order + in: query + description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + required: false + schema: + type: string + title: order + description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + externalDocs: + url: '#pagination' + - name: $and + in: query + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + required: false + schema: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + - name: $or + in: query + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + required: false + schema: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + - name: q + in: query + description: Query to search the product type's searchable fields. + required: false + schema: + type: string + title: q + description: Query to search the product type's searchable fields. + - name: id + in: query + required: false + schema: + oneOf: + - type: string + title: id + description: Filter by a product type's ID. + - type: array + description: Filter by product type IDs. + items: + type: string + title: id + description: A product type's ID. + - name: value + in: query + required: false + schema: + oneOf: + - type: string + title: value + description: Filter by a product type's value. + - type: array + description: Filter by product type values. + items: + type: string + title: value + description: A product type's value. + - name: created_at + in: query + description: Filter by the type's creation date. + required: false + schema: + type: object + description: Filter by the type's creation date. + properties: + $and: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: An exact match. + $ne: + type: string + title: $ne + description: Filter by values not equal to this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value not to match. + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter. + - type: object + description: Filter by values not matching the conditions in this parameter. + properties: + $and: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: The value to match. + $ne: + type: string + title: $ne + description: Filter by values not matching this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value to not match + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter + - type: object + description: Filter by values not matching the conditions in this parameter. + - type: array + description: Filter by values not matching the values of this parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: Filter by values greater than this parameter. Useful for numbers and dates only. + $gte: + type: string + title: $gte + description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: Filter by values less than this parameter. Useful for numbers and dates only. + $lte: + type: string + title: $lte + description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: The value to match. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). + - type: array + description: Filter by values not matching those in this parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: Filter by values greater than this parameter. Useful for numbers and dates only. + $gte: + type: string + title: $gte + description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: Filter by values less than this parameter. Useful for numbers and dates only. + $lte: + type: string + title: $lte + description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: The values to match. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). + - name: updated_at in: query - description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + description: Filter by the type's update date. required: false schema: - type: array - description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. - items: - type: object - title: $or + type: object + description: Filter by the type's update date. + properties: + $and: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: An exact match. + $ne: + type: string + title: $ne + description: Filter by values not equal to this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value not to match. + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter. + - type: object + description: Filter by values not matching the conditions in this parameter. + properties: + $and: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: The value to match. + $ne: + type: string + title: $ne + description: Filter by values not matching this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value to not match + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter + - type: object + description: Filter by values not matching the conditions in this parameter. + - type: array + description: Filter by values not matching the values of this parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: Filter by values greater than this parameter. Useful for numbers and dates only. + $gte: + type: string + title: $gte + description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: Filter by values less than this parameter. Useful for numbers and dates only. + $lte: + type: string + title: $lte + description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: The value to match. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). + - type: array + description: Filter by values not matching those in this parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: Filter by values greater than this parameter. Useful for numbers and dates only. + $gte: + type: string + title: $gte + description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: Filter by values less than this parameter. Useful for numbers and dates only. + $lte: + type: string + title: $lte + description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: The values to match. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). x-codeSamples: - lang: Shell label: cURL @@ -4931,8 +5927,8 @@ paths: in: query description: |- Comma-separated fields that should be included in the returned data. - * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. - * without prefix it will replace the entire default fields. + if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + without prefix it will replace the entire default fields. required: false schema: type: string @@ -6827,26 +7823,26 @@ components: x-schemaName: AdminBatchInventoryItemsLocationLevels AdminBatchInventoryItemsLocationLevelsResponse: type: object - description: SUMMARY + description: The result of managing inventory levels. x-schemaName: AdminBatchInventoryItemsLocationLevelsResponse properties: created: type: array - description: The inventory item's created. + description: The created inventory levels. items: $ref: '#/components/schemas/InventoryLevel' updated: type: array - description: The inventory item's updated. + description: The updated inventory levels. items: $ref: '#/components/schemas/InventoryLevel' deleted: type: array - description: SUMMARY + description: The IDs of deleted inventory levels. items: type: string title: deleted - description: SUMMARY + description: The ID of a deleted inventory level. AdminBatchProductRequest: type: object description: The products to create, update, or delete. @@ -16253,7 +17249,7 @@ components: $ref: '#/components/schemas/AdminShippingOption' AdminShippingOptionRule: type: object - description: The rule's rules. + description: The shipping option rule's details. x-schemaName: AdminShippingOptionRule required: - id @@ -16268,11 +17264,12 @@ components: id: type: string title: id - description: The rule's ID. + description: The shipping option rule's ID. attribute: type: string title: attribute - description: The rule's attribute. + description: The shipping option rule's attribute. + example: is_return operator: type: string description: The rule's operator. @@ -16286,35 +17283,27 @@ components: - gte - nin value: - oneOf: - - type: string - title: value - description: The rule's value. - - type: array - description: The rule's value. - items: - type: string - title: value - description: The value's details. + type: string + title: value shipping_option_id: type: string title: shipping_option_id - description: The rule's shipping option id. + description: The ID of the shipping option this rule is for. created_at: type: string format: date-time title: created_at - description: The rule's created at. + description: The date the shipping option rule was created. updated_at: type: string format: date-time title: updated_at - description: The rule's updated at. + description: The date the shipping option rule was updated. deleted_at: type: string format: date-time title: deleted_at - description: The rule's deleted at. + description: The date the shipping option rule was deleted. AdminShippingOptionType: type: object description: The shipping option's details. @@ -21882,7 +22871,7 @@ components: - unknown_error InventoryLevel: type: object - description: The created's details. + description: The inventory level's details x-schemaName: InventoryLevel required: - id @@ -21896,34 +22885,34 @@ components: id: type: string title: id - description: The created's ID. + description: The inventory level's ID. inventory_item_id: type: string title: inventory_item_id - description: The created's inventory item id. + description: The ID of the associated inventory item. location_id: type: string title: location_id - description: The created's location id. + description: The ID of the associated location. stocked_quantity: type: number title: stocked_quantity - description: The created's stocked quantity. + description: The inventory level's stocked quantity. reserved_quantity: type: number title: reserved_quantity - description: The created's reserved quantity. + description: The inventory level's reserved quantity. available_quantity: type: number title: available_quantity - description: The created's available quantity. + description: The inventory level's available quantity. incoming_quantity: type: number title: incoming_quantity - description: The created's incoming quantity. + description: The inventory level's incoming quantity. metadata: type: object - description: The created's metadata. + description: The inventory level's metadata, can hold custom key-value pairs. Order: type: object description: The order change's order. @@ -32038,7 +33027,7 @@ components: - updated_at StoreProductTagListResponse: type: object - description: SUMMARY + description: The paginated list of product tags. x-schemaName: StoreProductTagListResponse required: - limit @@ -32049,23 +33038,23 @@ components: limit: type: number title: limit - description: The product tag's limit. + description: The maximum number of items returned. offset: type: number title: offset - description: The product tag's offset. + description: The number of items to skip before retrieving the returned items. count: type: number title: count - description: The product tag's count. + description: The total number of items available. product_tags: type: array - description: The product tag's product tags. + description: The list of product tags. items: $ref: '#/components/schemas/StoreProductTag' StoreProductTagResponse: type: object - description: SUMMARY + description: The product tag's details. x-schemaName: StoreProductTagResponse required: - product_tag @@ -32074,7 +33063,7 @@ components: $ref: '#/components/schemas/StoreProductTag' StoreProductTypeListResponse: type: object - description: SUMMARY + description: The paginated list of product types. x-schemaName: StoreProductTypeListResponse required: - limit @@ -32085,23 +33074,23 @@ components: limit: type: number title: limit - description: The product type's limit. + description: The maximum number of items returned. offset: type: number title: offset - description: The product type's offset. + description: The number of items to skip before retrieving the returned items. count: type: number title: count - description: The product type's count. + description: The total number of items available. product_types: type: array - description: The product type's product types. + description: The list of product types. items: $ref: '#/components/schemas/StoreProduct' StoreProductTypeResponse: type: object - description: SUMMARY + description: The product type's details. x-schemaName: StoreProductTypeResponse required: - product_type diff --git a/www/apps/api-reference/specs/store/paths/store_product-tags.yaml b/www/apps/api-reference/specs/store/paths/store_product-tags.yaml index 6d77106be023d..e4c249058f720 100644 --- a/www/apps/api-reference/specs/store/paths/store_product-tags.yaml +++ b/www/apps/api-reference/specs/store/paths/store_product-tags.yaml @@ -16,10 +16,13 @@ get: url: https://docs.medusajs.com/api/store#publishable-api-key - name: fields in: query - description: |- + description: >- Comma-separated fields that should be included in the returned data. - * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. - * without prefix it will replace the entire default fields. + + if a field is prefixed with `+` it will be added to the default fields, + using `-` will remove it from the default fields. + + without prefix it will replace the entire default fields. required: false schema: type: string @@ -94,6 +97,580 @@ get: items: type: object title: $or + - name: q + in: query + description: Query to search product tag's searchable fields. + required: false + schema: + type: string + title: q + description: Query to search product tag's searchable fields. + - name: id + in: query + required: false + schema: + oneOf: + - type: string + title: id + description: Filter by a product tag's ID. + - type: array + description: Filter by product tag IDs. + items: + type: string + title: id + description: A product tag's ID. + - name: value + in: query + required: false + schema: + oneOf: + - type: string + title: value + description: Filter by a product tag's value. + - type: array + description: Filter by product tag values. + items: + type: string + title: value + description: A product tag's value. + - name: created_at + in: query + description: Filter by the tag's creation date. + required: false + schema: + type: object + description: Filter by the tag's creation date. + properties: + $and: + type: array + description: >- + Join query parameters with an AND condition. Each object's content + is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: >- + Join query parameters with an OR condition. Each object's content + is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: An exact match. + $ne: + type: string + title: $ne + description: Filter by values not equal to this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value not to match. + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter. + - type: object + description: >- + Filter by values not matching the conditions in this + parameter. + properties: + $and: + type: array + description: >- + Join query parameters with an AND condition. Each object's + content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: >- + Join query parameters with an OR condition. Each object's + content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: The value to match. + $ne: + type: string + title: $ne + description: Filter by values not matching this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value to not match + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter + - type: object + description: >- + Filter by values not matching the conditions in this + parameter. + - type: array + description: >- + Filter by values not matching the values of this + parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: >- + Filter by values greater than this parameter. Useful for + numbers and dates only. + $gte: + type: string + title: $gte + description: >- + Filter by values greater than or equal to this parameter. + Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: >- + Filter by values less than this parameter. Useful for + numbers and dates only. + $lte: + type: string + title: $lte + description: >- + Filter by values less than or equal to this parameter. + Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: >- + Apply a case-insensitive `like` filter. Useful for strings + only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: >- + Filter arrays that have overlapping values with this + parameter. + items: + type: string + title: $overlap + description: The value to match. + $contains: + type: array + description: >- + Filter arrays that contain some of the values of this + parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: >- + Filter by whether a value for this parameter exists (not + `null`). + - type: array + description: Filter by values not matching those in this parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: >- + Filter by values greater than this parameter. Useful for numbers + and dates only. + $gte: + type: string + title: $gte + description: >- + Filter by values greater than or equal to this parameter. Useful + for numbers and dates only. + $lt: + type: string + title: $lt + description: >- + Filter by values less than this parameter. Useful for numbers and + dates only. + $lte: + type: string + title: $lte + description: >- + Filter by values less than or equal to this parameter. Useful for + numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: The values to match. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). + - name: updated_at + in: query + description: Filter by the tag's update date. + required: false + schema: + type: object + description: Filter by the tag's update date. + properties: + $and: + type: array + description: >- + Join query parameters with an AND condition. Each object's content + is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: >- + Join query parameters with an OR condition. Each object's content + is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: An exact match. + $ne: + type: string + title: $ne + description: Filter by values not equal to this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value not to match. + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter. + - type: object + description: >- + Filter by values not matching the conditions in this + parameter. + properties: + $and: + type: array + description: >- + Join query parameters with an AND condition. Each object's + content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: >- + Join query parameters with an OR condition. Each object's + content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: The value to match. + $ne: + type: string + title: $ne + description: Filter by values not matching this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value to not match + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter + - type: object + description: >- + Filter by values not matching the conditions in this + parameter. + - type: array + description: >- + Filter by values not matching the values of this + parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: >- + Filter by values greater than this parameter. Useful for + numbers and dates only. + $gte: + type: string + title: $gte + description: >- + Filter by values greater than or equal to this parameter. + Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: >- + Filter by values less than this parameter. Useful for + numbers and dates only. + $lte: + type: string + title: $lte + description: >- + Filter by values less than or equal to this parameter. + Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: >- + Apply a case-insensitive `like` filter. Useful for strings + only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: >- + Filter arrays that have overlapping values with this + parameter. + items: + type: string + title: $overlap + description: The value to match. + $contains: + type: array + description: >- + Filter arrays that contain some of the values of this + parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: >- + Filter by whether a value for this parameter exists (not + `null`). + - type: array + description: Filter by values not matching those in this parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: >- + Filter by values greater than this parameter. Useful for numbers + and dates only. + $gte: + type: string + title: $gte + description: >- + Filter by values greater than or equal to this parameter. Useful + for numbers and dates only. + $lt: + type: string + title: $lt + description: >- + Filter by values less than this parameter. Useful for numbers and + dates only. + $lte: + type: string + title: $lte + description: >- + Filter by values less than or equal to this parameter. Useful for + numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: The values to match. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). x-codeSamples: - lang: Shell label: cURL diff --git a/www/apps/api-reference/specs/store/paths/store_product-tags_{id}.yaml b/www/apps/api-reference/specs/store/paths/store_product-tags_{id}.yaml index e5434364368a1..e00f236211841 100644 --- a/www/apps/api-reference/specs/store/paths/store_product-tags_{id}.yaml +++ b/www/apps/api-reference/specs/store/paths/store_product-tags_{id}.yaml @@ -22,10 +22,13 @@ get: url: https://docs.medusajs.com/api/store#publishable-api-key - name: fields in: query - description: |- + description: >- Comma-separated fields that should be included in the returned data. - * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. - * without prefix it will replace the entire default fields. + + if a field is prefixed with `+` it will be added to the default fields, + using `-` will remove it from the default fields. + + without prefix it will replace the entire default fields. required: false schema: type: string diff --git a/www/apps/api-reference/specs/store/paths/store_product-types.yaml b/www/apps/api-reference/specs/store/paths/store_product-types.yaml index 840c6c026dd72..0cb17e2b9e7d8 100644 --- a/www/apps/api-reference/specs/store/paths/store_product-types.yaml +++ b/www/apps/api-reference/specs/store/paths/store_product-types.yaml @@ -18,8 +18,8 @@ get: in: query description: |- Comma-separated fields that should be included in the returned data. - * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. - * without prefix it will replace the entire default fields. + if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + without prefix it will replace the entire default fields. required: false schema: type: string @@ -94,6 +94,580 @@ get: items: type: object title: $or + - name: q + in: query + description: Query to search the product type's searchable fields. + required: false + schema: + type: string + title: q + description: Query to search the product type's searchable fields. + - name: id + in: query + required: false + schema: + oneOf: + - type: string + title: id + description: Filter by a product type's ID. + - type: array + description: Filter by product type IDs. + items: + type: string + title: id + description: A product type's ID. + - name: value + in: query + required: false + schema: + oneOf: + - type: string + title: value + description: Filter by a product type's value. + - type: array + description: Filter by product type values. + items: + type: string + title: value + description: A product type's value. + - name: created_at + in: query + description: Filter by the type's creation date. + required: false + schema: + type: object + description: Filter by the type's creation date. + properties: + $and: + type: array + description: >- + Join query parameters with an AND condition. Each object's content + is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: >- + Join query parameters with an OR condition. Each object's content + is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: An exact match. + $ne: + type: string + title: $ne + description: Filter by values not equal to this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value not to match. + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter. + - type: object + description: >- + Filter by values not matching the conditions in this + parameter. + properties: + $and: + type: array + description: >- + Join query parameters with an AND condition. Each object's + content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: >- + Join query parameters with an OR condition. Each object's + content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: The value to match. + $ne: + type: string + title: $ne + description: Filter by values not matching this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value to not match + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter + - type: object + description: >- + Filter by values not matching the conditions in this + parameter. + - type: array + description: >- + Filter by values not matching the values of this + parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: >- + Filter by values greater than this parameter. Useful for + numbers and dates only. + $gte: + type: string + title: $gte + description: >- + Filter by values greater than or equal to this parameter. + Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: >- + Filter by values less than this parameter. Useful for + numbers and dates only. + $lte: + type: string + title: $lte + description: >- + Filter by values less than or equal to this parameter. + Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: >- + Apply a case-insensitive `like` filter. Useful for strings + only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: >- + Filter arrays that have overlapping values with this + parameter. + items: + type: string + title: $overlap + description: The value to match. + $contains: + type: array + description: >- + Filter arrays that contain some of the values of this + parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: >- + Filter by whether a value for this parameter exists (not + `null`). + - type: array + description: Filter by values not matching those in this parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: >- + Filter by values greater than this parameter. Useful for numbers + and dates only. + $gte: + type: string + title: $gte + description: >- + Filter by values greater than or equal to this parameter. Useful + for numbers and dates only. + $lt: + type: string + title: $lt + description: >- + Filter by values less than this parameter. Useful for numbers and + dates only. + $lte: + type: string + title: $lte + description: >- + Filter by values less than or equal to this parameter. Useful for + numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: The values to match. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). + - name: updated_at + in: query + description: Filter by the type's update date. + required: false + schema: + type: object + description: Filter by the type's update date. + properties: + $and: + type: array + description: >- + Join query parameters with an AND condition. Each object's content + is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: >- + Join query parameters with an OR condition. Each object's content + is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: An exact match. + $ne: + type: string + title: $ne + description: Filter by values not equal to this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value not to match. + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter. + - type: object + description: >- + Filter by values not matching the conditions in this + parameter. + properties: + $and: + type: array + description: >- + Join query parameters with an AND condition. Each object's + content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: >- + Join query parameters with an OR condition. Each object's + content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by multiple exact matches. + items: + type: string + title: $eq + description: The value to match. + $ne: + type: string + title: $ne + description: Filter by values not matching this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: The value to match. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: The value to not match + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching this parameter + - type: object + description: >- + Filter by values not matching the conditions in this + parameter. + - type: array + description: >- + Filter by values not matching the values of this + parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: >- + Filter by values greater than this parameter. Useful for + numbers and dates only. + $gte: + type: string + title: $gte + description: >- + Filter by values greater than or equal to this parameter. + Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: >- + Filter by values less than this parameter. Useful for + numbers and dates only. + $lte: + type: string + title: $lte + description: >- + Filter by values less than or equal to this parameter. + Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: >- + Apply a case-insensitive `like` filter. Useful for strings + only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: >- + Filter arrays that have overlapping values with this + parameter. + items: + type: string + title: $overlap + description: The value to match. + $contains: + type: array + description: >- + Filter arrays that contain some of the values of this + parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: >- + Filter by whether a value for this parameter exists (not + `null`). + - type: array + description: Filter by values not matching those in this parameter. + items: + type: string + title: $not + description: The values to not match. + $gt: + type: string + title: $gt + description: >- + Filter by values greater than this parameter. Useful for numbers + and dates only. + $gte: + type: string + title: $gte + description: >- + Filter by values greater than or equal to this parameter. Useful + for numbers and dates only. + $lt: + type: string + title: $lt + description: >- + Filter by values less than this parameter. Useful for numbers and + dates only. + $lte: + type: string + title: $lte + description: >- + Filter by values less than or equal to this parameter. Useful for + numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: The values to match. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: The values to match. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: The values to match. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). x-codeSamples: - lang: Shell label: cURL diff --git a/www/apps/api-reference/specs/store/paths/store_product-types_{id}.yaml b/www/apps/api-reference/specs/store/paths/store_product-types_{id}.yaml index f52b902a6c08d..40fb82c0cf000 100644 --- a/www/apps/api-reference/specs/store/paths/store_product-types_{id}.yaml +++ b/www/apps/api-reference/specs/store/paths/store_product-types_{id}.yaml @@ -24,8 +24,8 @@ get: in: query description: |- Comma-separated fields that should be included in the returned data. - * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. - * without prefix it will replace the entire default fields. + if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + without prefix it will replace the entire default fields. required: false schema: type: string diff --git a/www/utils/generated/oas-output/operations/store/get_store_product-tags.ts b/www/utils/generated/oas-output/operations/store/get_store_product-tags.ts index 518c8316bc07b..47c29d79ff1e5 100644 --- a/www/utils/generated/oas-output/operations/store/get_store_product-tags.ts +++ b/www/utils/generated/oas-output/operations/store/get_store_product-tags.ts @@ -17,8 +17,8 @@ * in: query * description: |- * Comma-separated fields that should be included in the returned data. - * * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. - * * without prefix it will replace the entire default fields. + * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * without prefix it will replace the entire default fields. * required: false * schema: * type: string @@ -77,6 +77,504 @@ * items: * type: object * title: $or + * - name: q + * in: query + * description: Query to search product tag's searchable fields. + * required: false + * schema: + * type: string + * title: q + * description: Query to search product tag's searchable fields. + * - name: id + * in: query + * required: false + * schema: + * oneOf: + * - type: string + * title: id + * description: Filter by a product tag's ID. + * - type: array + * description: Filter by product tag IDs. + * items: + * type: string + * title: id + * description: A product tag's ID. + * - name: value + * in: query + * required: false + * schema: + * oneOf: + * - type: string + * title: value + * description: Filter by a product tag's value. + * - type: array + * description: Filter by product tag values. + * items: + * type: string + * title: value + * description: A product tag's value. + * - name: created_at + * in: query + * description: Filter by the tag's creation date. + * required: false + * schema: + * type: object + * description: Filter by the tag's creation date. + * properties: + * $and: + * type: array + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $and + * $or: + * type: array + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $or + * $eq: + * oneOf: + * - type: string + * title: $eq + * description: Filter by an exact match. + * - type: array + * description: Filter by multiple exact matches. + * items: + * type: string + * title: $eq + * description: An exact match. + * $ne: + * type: string + * title: $ne + * description: Filter by values not equal to this parameter. + * $in: + * type: array + * description: Filter by values in this array. + * items: + * type: string + * title: $in + * description: The value to match. + * $nin: + * type: array + * description: Filter by values not in this array. + * items: + * type: string + * title: $nin + * description: The value not to match. + * $not: + * oneOf: + * - type: string + * title: $not + * description: Filter by values not matching this parameter. + * - type: object + * description: Filter by values not matching the conditions in this parameter. + * properties: + * $and: + * type: array + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $and + * $or: + * type: array + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $or + * $eq: + * oneOf: + * - type: string + * title: $eq + * description: Filter by an exact match. + * - type: array + * description: Filter by multiple exact matches. + * items: + * type: string + * title: $eq + * description: The value to match. + * $ne: + * type: string + * title: $ne + * description: Filter by values not matching this parameter. + * $in: + * type: array + * description: Filter by values in this array. + * items: + * type: string + * title: $in + * description: The value to match. + * $nin: + * type: array + * description: Filter by values not in this array. + * items: + * type: string + * title: $nin + * description: The value to not match + * $not: + * oneOf: + * - type: string + * title: $not + * description: Filter by values not matching this parameter + * - type: object + * description: Filter by values not matching the conditions in this parameter. + * - type: array + * description: Filter by values not matching the values of this parameter. + * items: + * type: string + * title: $not + * description: The values to not match. + * $gt: + * type: string + * title: $gt + * description: Filter by values greater than this parameter. Useful for numbers and dates only. + * $gte: + * type: string + * title: $gte + * description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + * $lt: + * type: string + * title: $lt + * description: Filter by values less than this parameter. Useful for numbers and dates only. + * $lte: + * type: string + * title: $lte + * description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + * $like: + * type: string + * title: $like + * description: Apply a `like` filter. Useful for strings only. + * $re: + * type: string + * title: $re + * description: Apply a regex filter. Useful for strings only. + * $ilike: + * type: string + * title: $ilike + * description: Apply a case-insensitive `like` filter. Useful for strings only. + * $fulltext: + * type: string + * title: $fulltext + * description: Filter to apply on full-text properties. + * $overlap: + * type: array + * description: Filter arrays that have overlapping values with this parameter. + * items: + * type: string + * title: $overlap + * description: The value to match. + * $contains: + * type: array + * description: Filter arrays that contain some of the values of this parameter. + * items: + * type: string + * title: $contains + * description: The values to match. + * $contained: + * type: array + * description: Filter arrays that contain all values of this parameter. + * items: + * type: string + * title: $contained + * description: The values to match. + * $exists: + * type: boolean + * title: $exists + * description: Filter by whether a value for this parameter exists (not `null`). + * - type: array + * description: Filter by values not matching those in this parameter. + * items: + * type: string + * title: $not + * description: The values to not match. + * $gt: + * type: string + * title: $gt + * description: Filter by values greater than this parameter. Useful for numbers and dates only. + * $gte: + * type: string + * title: $gte + * description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + * $lt: + * type: string + * title: $lt + * description: Filter by values less than this parameter. Useful for numbers and dates only. + * $lte: + * type: string + * title: $lte + * description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + * $like: + * type: string + * title: $like + * description: Apply a `like` filter. Useful for strings only. + * $re: + * type: string + * title: $re + * description: Apply a regex filter. Useful for strings only. + * $ilike: + * type: string + * title: $ilike + * description: Apply a case-insensitive `like` filter. Useful for strings only. + * $fulltext: + * type: string + * title: $fulltext + * description: Filter to apply on full-text properties. + * $overlap: + * type: array + * description: Filter arrays that have overlapping values with this parameter. + * items: + * type: string + * title: $overlap + * description: The values to match. + * $contains: + * type: array + * description: Filter arrays that contain some of the values of this parameter. + * items: + * type: string + * title: $contains + * description: The values to match. + * $contained: + * type: array + * description: Filter arrays that contain all values of this parameter. + * items: + * type: string + * title: $contained + * description: The values to match. + * $exists: + * type: boolean + * title: $exists + * description: Filter by whether a value for this parameter exists (not `null`). + * - name: updated_at + * in: query + * description: Filter by the tag's update date. + * required: false + * schema: + * type: object + * description: Filter by the tag's update date. + * properties: + * $and: + * type: array + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $and + * $or: + * type: array + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $or + * $eq: + * oneOf: + * - type: string + * title: $eq + * description: Filter by an exact match. + * - type: array + * description: Filter by multiple exact matches. + * items: + * type: string + * title: $eq + * description: An exact match. + * $ne: + * type: string + * title: $ne + * description: Filter by values not equal to this parameter. + * $in: + * type: array + * description: Filter by values in this array. + * items: + * type: string + * title: $in + * description: The value to match. + * $nin: + * type: array + * description: Filter by values not in this array. + * items: + * type: string + * title: $nin + * description: The value not to match. + * $not: + * oneOf: + * - type: string + * title: $not + * description: Filter by values not matching this parameter. + * - type: object + * description: Filter by values not matching the conditions in this parameter. + * properties: + * $and: + * type: array + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $and + * $or: + * type: array + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $or + * $eq: + * oneOf: + * - type: string + * title: $eq + * description: Filter by an exact match. + * - type: array + * description: Filter by multiple exact matches. + * items: + * type: string + * title: $eq + * description: The value to match. + * $ne: + * type: string + * title: $ne + * description: Filter by values not matching this parameter. + * $in: + * type: array + * description: Filter by values in this array. + * items: + * type: string + * title: $in + * description: The value to match. + * $nin: + * type: array + * description: Filter by values not in this array. + * items: + * type: string + * title: $nin + * description: The value to not match + * $not: + * oneOf: + * - type: string + * title: $not + * description: Filter by values not matching this parameter + * - type: object + * description: Filter by values not matching the conditions in this parameter. + * - type: array + * description: Filter by values not matching the values of this parameter. + * items: + * type: string + * title: $not + * description: The values to not match. + * $gt: + * type: string + * title: $gt + * description: Filter by values greater than this parameter. Useful for numbers and dates only. + * $gte: + * type: string + * title: $gte + * description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + * $lt: + * type: string + * title: $lt + * description: Filter by values less than this parameter. Useful for numbers and dates only. + * $lte: + * type: string + * title: $lte + * description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + * $like: + * type: string + * title: $like + * description: Apply a `like` filter. Useful for strings only. + * $re: + * type: string + * title: $re + * description: Apply a regex filter. Useful for strings only. + * $ilike: + * type: string + * title: $ilike + * description: Apply a case-insensitive `like` filter. Useful for strings only. + * $fulltext: + * type: string + * title: $fulltext + * description: Filter to apply on full-text properties. + * $overlap: + * type: array + * description: Filter arrays that have overlapping values with this parameter. + * items: + * type: string + * title: $overlap + * description: The value to match. + * $contains: + * type: array + * description: Filter arrays that contain some of the values of this parameter. + * items: + * type: string + * title: $contains + * description: The values to match. + * $contained: + * type: array + * description: Filter arrays that contain all values of this parameter. + * items: + * type: string + * title: $contained + * description: The values to match. + * $exists: + * type: boolean + * title: $exists + * description: Filter by whether a value for this parameter exists (not `null`). + * - type: array + * description: Filter by values not matching those in this parameter. + * items: + * type: string + * title: $not + * description: The values to not match. + * $gt: + * type: string + * title: $gt + * description: Filter by values greater than this parameter. Useful for numbers and dates only. + * $gte: + * type: string + * title: $gte + * description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + * $lt: + * type: string + * title: $lt + * description: Filter by values less than this parameter. Useful for numbers and dates only. + * $lte: + * type: string + * title: $lte + * description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + * $like: + * type: string + * title: $like + * description: Apply a `like` filter. Useful for strings only. + * $re: + * type: string + * title: $re + * description: Apply a regex filter. Useful for strings only. + * $ilike: + * type: string + * title: $ilike + * description: Apply a case-insensitive `like` filter. Useful for strings only. + * $fulltext: + * type: string + * title: $fulltext + * description: Filter to apply on full-text properties. + * $overlap: + * type: array + * description: Filter arrays that have overlapping values with this parameter. + * items: + * type: string + * title: $overlap + * description: The values to match. + * $contains: + * type: array + * description: Filter arrays that contain some of the values of this parameter. + * items: + * type: string + * title: $contains + * description: The values to match. + * $contained: + * type: array + * description: Filter arrays that contain all values of this parameter. + * items: + * type: string + * title: $contained + * description: The values to match. + * $exists: + * type: boolean + * title: $exists + * description: Filter by whether a value for this parameter exists (not `null`). * x-codeSamples: * - lang: Shell * label: cURL diff --git a/www/utils/generated/oas-output/operations/store/get_store_product-tags_[id].ts b/www/utils/generated/oas-output/operations/store/get_store_product-tags_[id].ts index 3a995bdd66f80..b53c69560e131 100644 --- a/www/utils/generated/oas-output/operations/store/get_store_product-tags_[id].ts +++ b/www/utils/generated/oas-output/operations/store/get_store_product-tags_[id].ts @@ -23,8 +23,8 @@ * in: query * description: |- * Comma-separated fields that should be included in the returned data. - * * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. - * * without prefix it will replace the entire default fields. + * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * without prefix it will replace the entire default fields. * required: false * schema: * type: string diff --git a/www/utils/generated/oas-output/operations/store/get_store_product-types.ts b/www/utils/generated/oas-output/operations/store/get_store_product-types.ts index eb8ffb1e6ef5a..2d0c521566888 100644 --- a/www/utils/generated/oas-output/operations/store/get_store_product-types.ts +++ b/www/utils/generated/oas-output/operations/store/get_store_product-types.ts @@ -17,8 +17,8 @@ * in: query * description: |- * Comma-separated fields that should be included in the returned data. - * * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. - * * without prefix it will replace the entire default fields. + * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * without prefix it will replace the entire default fields. * required: false * schema: * type: string @@ -77,6 +77,504 @@ * items: * type: object * title: $or + * - name: q + * in: query + * description: Query to search the product type's searchable fields. + * required: false + * schema: + * type: string + * title: q + * description: Query to search the product type's searchable fields. + * - name: id + * in: query + * required: false + * schema: + * oneOf: + * - type: string + * title: id + * description: Filter by a product type's ID. + * - type: array + * description: Filter by product type IDs. + * items: + * type: string + * title: id + * description: A product type's ID. + * - name: value + * in: query + * required: false + * schema: + * oneOf: + * - type: string + * title: value + * description: Filter by a product type's value. + * - type: array + * description: Filter by product type values. + * items: + * type: string + * title: value + * description: A product type's value. + * - name: created_at + * in: query + * description: Filter by the type's creation date. + * required: false + * schema: + * type: object + * description: Filter by the type's creation date. + * properties: + * $and: + * type: array + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $and + * $or: + * type: array + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $or + * $eq: + * oneOf: + * - type: string + * title: $eq + * description: Filter by an exact match. + * - type: array + * description: Filter by multiple exact matches. + * items: + * type: string + * title: $eq + * description: An exact match. + * $ne: + * type: string + * title: $ne + * description: Filter by values not equal to this parameter. + * $in: + * type: array + * description: Filter by values in this array. + * items: + * type: string + * title: $in + * description: The value to match. + * $nin: + * type: array + * description: Filter by values not in this array. + * items: + * type: string + * title: $nin + * description: The value not to match. + * $not: + * oneOf: + * - type: string + * title: $not + * description: Filter by values not matching this parameter. + * - type: object + * description: Filter by values not matching the conditions in this parameter. + * properties: + * $and: + * type: array + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $and + * $or: + * type: array + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $or + * $eq: + * oneOf: + * - type: string + * title: $eq + * description: Filter by an exact match. + * - type: array + * description: Filter by multiple exact matches. + * items: + * type: string + * title: $eq + * description: The value to match. + * $ne: + * type: string + * title: $ne + * description: Filter by values not matching this parameter. + * $in: + * type: array + * description: Filter by values in this array. + * items: + * type: string + * title: $in + * description: The value to match. + * $nin: + * type: array + * description: Filter by values not in this array. + * items: + * type: string + * title: $nin + * description: The value to not match + * $not: + * oneOf: + * - type: string + * title: $not + * description: Filter by values not matching this parameter + * - type: object + * description: Filter by values not matching the conditions in this parameter. + * - type: array + * description: Filter by values not matching the values of this parameter. + * items: + * type: string + * title: $not + * description: The values to not match. + * $gt: + * type: string + * title: $gt + * description: Filter by values greater than this parameter. Useful for numbers and dates only. + * $gte: + * type: string + * title: $gte + * description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + * $lt: + * type: string + * title: $lt + * description: Filter by values less than this parameter. Useful for numbers and dates only. + * $lte: + * type: string + * title: $lte + * description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + * $like: + * type: string + * title: $like + * description: Apply a `like` filter. Useful for strings only. + * $re: + * type: string + * title: $re + * description: Apply a regex filter. Useful for strings only. + * $ilike: + * type: string + * title: $ilike + * description: Apply a case-insensitive `like` filter. Useful for strings only. + * $fulltext: + * type: string + * title: $fulltext + * description: Filter to apply on full-text properties. + * $overlap: + * type: array + * description: Filter arrays that have overlapping values with this parameter. + * items: + * type: string + * title: $overlap + * description: The value to match. + * $contains: + * type: array + * description: Filter arrays that contain some of the values of this parameter. + * items: + * type: string + * title: $contains + * description: The values to match. + * $contained: + * type: array + * description: Filter arrays that contain all values of this parameter. + * items: + * type: string + * title: $contained + * description: The values to match. + * $exists: + * type: boolean + * title: $exists + * description: Filter by whether a value for this parameter exists (not `null`). + * - type: array + * description: Filter by values not matching those in this parameter. + * items: + * type: string + * title: $not + * description: The values to not match. + * $gt: + * type: string + * title: $gt + * description: Filter by values greater than this parameter. Useful for numbers and dates only. + * $gte: + * type: string + * title: $gte + * description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + * $lt: + * type: string + * title: $lt + * description: Filter by values less than this parameter. Useful for numbers and dates only. + * $lte: + * type: string + * title: $lte + * description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + * $like: + * type: string + * title: $like + * description: Apply a `like` filter. Useful for strings only. + * $re: + * type: string + * title: $re + * description: Apply a regex filter. Useful for strings only. + * $ilike: + * type: string + * title: $ilike + * description: Apply a case-insensitive `like` filter. Useful for strings only. + * $fulltext: + * type: string + * title: $fulltext + * description: Filter to apply on full-text properties. + * $overlap: + * type: array + * description: Filter arrays that have overlapping values with this parameter. + * items: + * type: string + * title: $overlap + * description: The values to match. + * $contains: + * type: array + * description: Filter arrays that contain some of the values of this parameter. + * items: + * type: string + * title: $contains + * description: The values to match. + * $contained: + * type: array + * description: Filter arrays that contain all values of this parameter. + * items: + * type: string + * title: $contained + * description: The values to match. + * $exists: + * type: boolean + * title: $exists + * description: Filter by whether a value for this parameter exists (not `null`). + * - name: updated_at + * in: query + * description: Filter by the type's update date. + * required: false + * schema: + * type: object + * description: Filter by the type's update date. + * properties: + * $and: + * type: array + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $and + * $or: + * type: array + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $or + * $eq: + * oneOf: + * - type: string + * title: $eq + * description: Filter by an exact match. + * - type: array + * description: Filter by multiple exact matches. + * items: + * type: string + * title: $eq + * description: An exact match. + * $ne: + * type: string + * title: $ne + * description: Filter by values not equal to this parameter. + * $in: + * type: array + * description: Filter by values in this array. + * items: + * type: string + * title: $in + * description: The value to match. + * $nin: + * type: array + * description: Filter by values not in this array. + * items: + * type: string + * title: $nin + * description: The value not to match. + * $not: + * oneOf: + * - type: string + * title: $not + * description: Filter by values not matching this parameter. + * - type: object + * description: Filter by values not matching the conditions in this parameter. + * properties: + * $and: + * type: array + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $and + * $or: + * type: array + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $or + * $eq: + * oneOf: + * - type: string + * title: $eq + * description: Filter by an exact match. + * - type: array + * description: Filter by multiple exact matches. + * items: + * type: string + * title: $eq + * description: The value to match. + * $ne: + * type: string + * title: $ne + * description: Filter by values not matching this parameter. + * $in: + * type: array + * description: Filter by values in this array. + * items: + * type: string + * title: $in + * description: The value to match. + * $nin: + * type: array + * description: Filter by values not in this array. + * items: + * type: string + * title: $nin + * description: The value to not match + * $not: + * oneOf: + * - type: string + * title: $not + * description: Filter by values not matching this parameter + * - type: object + * description: Filter by values not matching the conditions in this parameter. + * - type: array + * description: Filter by values not matching the values of this parameter. + * items: + * type: string + * title: $not + * description: The values to not match. + * $gt: + * type: string + * title: $gt + * description: Filter by values greater than this parameter. Useful for numbers and dates only. + * $gte: + * type: string + * title: $gte + * description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + * $lt: + * type: string + * title: $lt + * description: Filter by values less than this parameter. Useful for numbers and dates only. + * $lte: + * type: string + * title: $lte + * description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + * $like: + * type: string + * title: $like + * description: Apply a `like` filter. Useful for strings only. + * $re: + * type: string + * title: $re + * description: Apply a regex filter. Useful for strings only. + * $ilike: + * type: string + * title: $ilike + * description: Apply a case-insensitive `like` filter. Useful for strings only. + * $fulltext: + * type: string + * title: $fulltext + * description: Filter to apply on full-text properties. + * $overlap: + * type: array + * description: Filter arrays that have overlapping values with this parameter. + * items: + * type: string + * title: $overlap + * description: The value to match. + * $contains: + * type: array + * description: Filter arrays that contain some of the values of this parameter. + * items: + * type: string + * title: $contains + * description: The values to match. + * $contained: + * type: array + * description: Filter arrays that contain all values of this parameter. + * items: + * type: string + * title: $contained + * description: The values to match. + * $exists: + * type: boolean + * title: $exists + * description: Filter by whether a value for this parameter exists (not `null`). + * - type: array + * description: Filter by values not matching those in this parameter. + * items: + * type: string + * title: $not + * description: The values to not match. + * $gt: + * type: string + * title: $gt + * description: Filter by values greater than this parameter. Useful for numbers and dates only. + * $gte: + * type: string + * title: $gte + * description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + * $lt: + * type: string + * title: $lt + * description: Filter by values less than this parameter. Useful for numbers and dates only. + * $lte: + * type: string + * title: $lte + * description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + * $like: + * type: string + * title: $like + * description: Apply a `like` filter. Useful for strings only. + * $re: + * type: string + * title: $re + * description: Apply a regex filter. Useful for strings only. + * $ilike: + * type: string + * title: $ilike + * description: Apply a case-insensitive `like` filter. Useful for strings only. + * $fulltext: + * type: string + * title: $fulltext + * description: Filter to apply on full-text properties. + * $overlap: + * type: array + * description: Filter arrays that have overlapping values with this parameter. + * items: + * type: string + * title: $overlap + * description: The values to match. + * $contains: + * type: array + * description: Filter arrays that contain some of the values of this parameter. + * items: + * type: string + * title: $contains + * description: The values to match. + * $contained: + * type: array + * description: Filter arrays that contain all values of this parameter. + * items: + * type: string + * title: $contained + * description: The values to match. + * $exists: + * type: boolean + * title: $exists + * description: Filter by whether a value for this parameter exists (not `null`). * x-codeSamples: * - lang: Shell * label: cURL diff --git a/www/utils/generated/oas-output/operations/store/get_store_product-types_[id].ts b/www/utils/generated/oas-output/operations/store/get_store_product-types_[id].ts index 226cbec788675..6a2142157f175 100644 --- a/www/utils/generated/oas-output/operations/store/get_store_product-types_[id].ts +++ b/www/utils/generated/oas-output/operations/store/get_store_product-types_[id].ts @@ -23,8 +23,8 @@ * in: query * description: |- * Comma-separated fields that should be included in the returned data. - * * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. - * * without prefix it will replace the entire default fields. + * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. + * without prefix it will replace the entire default fields. * required: false * schema: * type: string diff --git a/www/utils/generated/oas-output/schemas/AdminBatchInventoryItemsLocationLevelsResponse.ts b/www/utils/generated/oas-output/schemas/AdminBatchInventoryItemsLocationLevelsResponse.ts index 292b2a1661133..896814d0e6758 100644 --- a/www/utils/generated/oas-output/schemas/AdminBatchInventoryItemsLocationLevelsResponse.ts +++ b/www/utils/generated/oas-output/schemas/AdminBatchInventoryItemsLocationLevelsResponse.ts @@ -1,26 +1,26 @@ /** * @schema AdminBatchInventoryItemsLocationLevelsResponse * type: object - * description: SUMMARY + * description: The result of managing inventory levels. * x-schemaName: AdminBatchInventoryItemsLocationLevelsResponse * properties: * created: * type: array - * description: The inventory item's created. + * description: The created inventory levels. * items: * $ref: "#/components/schemas/InventoryLevel" * updated: * type: array - * description: The inventory item's updated. + * description: The updated inventory levels. * items: * $ref: "#/components/schemas/InventoryLevel" * deleted: * type: array - * description: SUMMARY + * description: The IDs of deleted inventory levels. * items: * type: string * title: deleted - * description: SUMMARY + * description: The ID of a deleted inventory level. * */ diff --git a/www/utils/generated/oas-output/schemas/AdminShippingOptionRule.ts b/www/utils/generated/oas-output/schemas/AdminShippingOptionRule.ts index 5401833495f39..1d1ec700837b2 100644 --- a/www/utils/generated/oas-output/schemas/AdminShippingOptionRule.ts +++ b/www/utils/generated/oas-output/schemas/AdminShippingOptionRule.ts @@ -1,7 +1,7 @@ /** * @schema AdminShippingOptionRule * type: object - * description: The rule's rules. + * description: The shipping option rule's details. * x-schemaName: AdminShippingOptionRule * required: * - id @@ -16,11 +16,12 @@ * id: * type: string * title: id - * description: The rule's ID. + * description: The shipping option rule's ID. * attribute: * type: string * title: attribute - * description: The rule's attribute. + * description: The shipping option rule's attribute. + * example: is_return * operator: * type: string * description: The rule's operator. @@ -34,35 +35,26 @@ * - gte * - nin * value: - * oneOf: - * - type: string - * title: value - * description: The rule's value. - * - type: array - * description: The rule's value. - * items: - * type: string - * title: value - * description: The value's details. + * type: string + * title: value * shipping_option_id: * type: string * title: shipping_option_id - * description: The rule's shipping option id. + * description: The ID of the shipping option this rule is for. * created_at: * type: string * format: date-time * title: created_at - * description: The rule's created at. + * description: The date the shipping option rule was created. * updated_at: * type: string * format: date-time * title: updated_at - * description: The rule's updated at. + * description: The date the shipping option rule was updated. * deleted_at: * type: string * format: date-time * title: deleted_at - * description: The rule's deleted at. - * -*/ - + * description: The date the shipping option rule was deleted. + * + */ diff --git a/www/utils/generated/oas-output/schemas/InventoryLevel.ts b/www/utils/generated/oas-output/schemas/InventoryLevel.ts index 5027840dbf1d4..2f537ca249eba 100644 --- a/www/utils/generated/oas-output/schemas/InventoryLevel.ts +++ b/www/utils/generated/oas-output/schemas/InventoryLevel.ts @@ -1,7 +1,7 @@ /** * @schema InventoryLevel * type: object - * description: The created's details. + * description: The inventory level's details * x-schemaName: InventoryLevel * required: * - id @@ -15,34 +15,34 @@ * id: * type: string * title: id - * description: The created's ID. + * description: The inventory level's ID. * inventory_item_id: * type: string * title: inventory_item_id - * description: The created's inventory item id. + * description: The ID of the associated inventory item. * location_id: * type: string * title: location_id - * description: The created's location id. + * description: The ID of the associated location. * stocked_quantity: * type: number * title: stocked_quantity - * description: The created's stocked quantity. + * description: The inventory level's stocked quantity. * reserved_quantity: * type: number * title: reserved_quantity - * description: The created's reserved quantity. + * description: The inventory level's reserved quantity. * available_quantity: * type: number * title: available_quantity - * description: The created's available quantity. + * description: The inventory level's available quantity. * incoming_quantity: * type: number * title: incoming_quantity - * description: The created's incoming quantity. + * description: The inventory level's incoming quantity. * metadata: * type: object - * description: The created's metadata. + * description: The inventory level's metadata, can hold custom key-value pairs. * */ diff --git a/www/utils/generated/oas-output/schemas/StoreProductTagListResponse.ts b/www/utils/generated/oas-output/schemas/StoreProductTagListResponse.ts index efd638e0555ec..bafc034f40aa9 100644 --- a/www/utils/generated/oas-output/schemas/StoreProductTagListResponse.ts +++ b/www/utils/generated/oas-output/schemas/StoreProductTagListResponse.ts @@ -1,7 +1,7 @@ /** * @schema StoreProductTagListResponse * type: object - * description: SUMMARY + * description: The paginated list of product tags. * x-schemaName: StoreProductTagListResponse * required: * - limit @@ -12,18 +12,18 @@ * limit: * type: number * title: limit - * description: The product tag's limit. + * description: The maximum number of items returned. * offset: * type: number * title: offset - * description: The product tag's offset. + * description: The number of items to skip before retrieving the returned items. * count: * type: number * title: count - * description: The product tag's count. + * description: The total number of items available. * product_tags: * type: array - * description: The product tag's product tags. + * description: The list of product tags. * items: * $ref: "#/components/schemas/StoreProductTag" * diff --git a/www/utils/generated/oas-output/schemas/StoreProductTagResponse.ts b/www/utils/generated/oas-output/schemas/StoreProductTagResponse.ts index c5472b2e56258..421858f8ff49e 100644 --- a/www/utils/generated/oas-output/schemas/StoreProductTagResponse.ts +++ b/www/utils/generated/oas-output/schemas/StoreProductTagResponse.ts @@ -1,7 +1,7 @@ /** * @schema StoreProductTagResponse * type: object - * description: SUMMARY + * description: The product tag's details. * x-schemaName: StoreProductTagResponse * required: * - product_tag diff --git a/www/utils/generated/oas-output/schemas/StoreProductTypeListResponse.ts b/www/utils/generated/oas-output/schemas/StoreProductTypeListResponse.ts index 4d29bb2f035b3..da6d7d8e38085 100644 --- a/www/utils/generated/oas-output/schemas/StoreProductTypeListResponse.ts +++ b/www/utils/generated/oas-output/schemas/StoreProductTypeListResponse.ts @@ -1,7 +1,7 @@ /** * @schema StoreProductTypeListResponse * type: object - * description: SUMMARY + * description: The paginated list of product types. * x-schemaName: StoreProductTypeListResponse * required: * - limit @@ -12,18 +12,18 @@ * limit: * type: number * title: limit - * description: The product type's limit. + * description: The maximum number of items returned. * offset: * type: number * title: offset - * description: The product type's offset. + * description: The number of items to skip before retrieving the returned items. * count: * type: number * title: count - * description: The product type's count. + * description: The total number of items available. * product_types: * type: array - * description: The product type's product types. + * description: The list of product types. * items: * $ref: "#/components/schemas/StoreProduct" * diff --git a/www/utils/generated/oas-output/schemas/StoreProductTypeResponse.ts b/www/utils/generated/oas-output/schemas/StoreProductTypeResponse.ts index 9ff0fa37d3308..42e8f65dc2290 100644 --- a/www/utils/generated/oas-output/schemas/StoreProductTypeResponse.ts +++ b/www/utils/generated/oas-output/schemas/StoreProductTypeResponse.ts @@ -1,7 +1,7 @@ /** * @schema StoreProductTypeResponse * type: object - * description: SUMMARY + * description: The product type's details. * x-schemaName: StoreProductTypeResponse * required: * - product_type