docs: fix broken links in OAS (#14000)

This commit is contained in:
Shahed Nasser
2025-11-07 10:48:37 +02:00
committed by GitHub
parent 5a96bb7da4
commit 6cd40c9f74
169 changed files with 291 additions and 300 deletions
@@ -60,8 +60,7 @@ properties:
type: array
description: The claim's transactions.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
description: Learn more about transactions of orders and associated models.
items:
$ref: ./BaseOrderTransaction.yaml
@@ -28,7 +28,7 @@ properties:
handling its processing.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
price_type:
type: string
description: >-
@@ -42,7 +42,7 @@ properties:
description: Any data useful for the fulfillment provider to handle the fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
description: Learn more about the data property.
packed_at:
type: string
@@ -39,7 +39,7 @@ properties:
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
metadata:
type: object
description: The tax rate's metadata, used to store custom key-value pairs.
@@ -47,7 +47,7 @@ properties:
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
metadata:
type: object
description: The default tax rate's metadata, used to store custom key-value pairs.
@@ -353,7 +353,7 @@ properties:
shipment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -59,8 +59,7 @@ properties:
type: array
description: The exchange's transactions.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
items:
$ref: ./BaseOrderTransaction.yaml
metadata:
@@ -73,7 +73,7 @@ properties:
fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The fulfillment's metadata, can hold custom key-value pairs.
@@ -51,7 +51,7 @@ properties:
the associated shipping option.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
provider_id:
type: string
title: provider_id
@@ -355,7 +355,7 @@ properties:
shipment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -56,7 +56,7 @@ properties:
fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -32,7 +32,7 @@ properties:
description: The payment's data, useful for processing by the payment provider.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment#whats-a-payment
https://docs.medusajs.com/resources/commerce-modules/payment/payment#whats-a-payment
created_at:
type: string
format: date-time
@@ -26,7 +26,7 @@ properties:
payment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment-session#data-property
https://docs.medusajs.com/resources/commerce-modules/payment/payment-session#data-property
context:
type: object
description: The context around the payment, such as the customer's details.
@@ -84,7 +84,7 @@ properties:
fulfillments created from this option.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping option's metadata, can hold custom key-value pairs.
@@ -50,7 +50,7 @@ properties:
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
is_default:
type: boolean
title: is_default
@@ -29,7 +29,7 @@ properties:
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
metadata:
type: object
description: The tax rate's metadata, can hold custom key-value pairs.
@@ -51,7 +51,7 @@ properties:
the associated shipping option.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
provider_id:
type: string
title: provider_id
@@ -56,7 +56,7 @@ properties:
fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -32,7 +32,7 @@ properties:
description: The payment's data, useful for processing by the payment provider.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment#whats-a-payment
https://docs.medusajs.com/resources/commerce-modules/payment/payment#whats-a-payment
created_at:
type: string
format: date-time
@@ -56,8 +56,7 @@ properties:
type: array
description: The claim's transactions.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
description: Learn more about transactions of orders and associated models.
items:
$ref: ./OrderTransaction.yaml
@@ -52,8 +52,7 @@ properties:
type: array
description: The exchange's transactions.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
items:
$ref: ./OrderTransaction.yaml
metadata:
@@ -53,7 +53,7 @@ properties:
the fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -45,7 +45,7 @@ properties:
services.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/cart/concepts#data-property
https://docs.medusajs.com/resources/commerce-modules/cart/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -94,7 +94,7 @@ properties:
description: The shipping option's data, useful for the provider handling fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
prices:
type: array
description: The shipping option's prices.
@@ -13,6 +13,6 @@ properties:
description: Any data necessary for the payment provider to process the payment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment-session#data-property
https://docs.medusajs.com/resources/commerce-modules/payment/payment-session#data-property
description: Learn more about the payment session's data property
x-schemaName: StoreInitializePaymentSession
@@ -51,7 +51,7 @@ properties:
the associated shipping option.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
provider_id:
type: string
title: provider_id
@@ -56,7 +56,7 @@ properties:
fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -26,7 +26,7 @@ properties:
payment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment-session#data-property
https://docs.medusajs.com/resources/commerce-modules/payment/payment-session#data-property
context:
type: object
description: The context around the payment, such as the customer's details.
@@ -102,7 +102,7 @@ properties:
is always considered in stock.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/products/inventory
https://docs.medusajs.com/resources/storefront-development/products/inventory
description: 'Storefront guide: How to retrieve a product variant''s inventory details.'
inventory_quantity:
type: number
@@ -112,7 +112,7 @@ properties:
pass `+variants.inventory_quantity` in the `fields` query parameter.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/products/inventory
https://docs.medusajs.com/resources/storefront-development/products/inventory
description: 'Storefront guide: How to retrieve a product variant''s inventory details.'
variant_rank:
type: number
@@ -66,7 +66,7 @@ properties:
description: The shipping option's data, useful for the provider handling fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping option's metadata, can hold custom key-value pairs.
@@ -15063,7 +15063,7 @@ paths:
type: object
description: The shipping method's data, useful for fulfillment providers.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
url: https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
amount:
oneOf:
- type: string
@@ -39685,7 +39685,7 @@ paths:
type: string
description: The promotion's type.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/promotion/concepts#what-is-a-promotion
url: https://docs.medusajs.com/resources/commerce-modules/promotion/concepts#what-is-a-promotion
enum:
- standard
- buyget
@@ -40429,7 +40429,7 @@ paths:
type: string
description: The promotion's type.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/promotion/concepts#what-is-a-promotion
url: https://docs.medusajs.com/resources/commerce-modules/promotion/concepts#what-is-a-promotion
enum:
- standard
- buyget
@@ -59033,7 +59033,7 @@ paths:
summary: Refresh Authentication Token
description: Refresh the authentication token of a user. This is useful after authenticating a user with a third-party service to ensure the token holds the new user's details, or when you don't want users to re-login every day.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#2-third-party-service-authenticate-flow
url: https://docs.medusajs.com/resources/commerce-modules/auth/authentication-route#2-third-party-service-authenticate-flow
description: Learn about third-party authentication flow.
x-authenticated: true
x-codeSamples:
@@ -59089,7 +59089,7 @@ paths:
When used with a third-party provider, such as Google, the request returns a `location` property. You redirect to the specified URL in your frontend to continue authentication with the third-party service.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#types-of-authentication-flows
url: https://docs.medusajs.com/resources/commerce-modules/auth/authentication-route#types-of-authentication-flows
description: Learn about different authentication flows.
x-authenticated: false
parameters:
@@ -59178,7 +59178,7 @@ paths:
You can decode the JWT token using libraries like [react-jwt](https://www.npmjs.com/package/react-jwt) in the frontend. If the decoded data doesn't have an `actor_id` property, then you must create a user, typically using the Accept Invite route passing the token in the request's Authorization header.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#2-third-party-service-authenticate-flow
url: https://docs.medusajs.com/resources/commerce-modules/auth/authentication-route#2-third-party-service-authenticate-flow
description: Learn about third-party authentication flow.
x-authenticated: false
parameters:
@@ -59285,7 +59285,7 @@ paths:
summary: Retrieve Registration JWT Token
description: This API route retrieves a registration JWT token of a user that hasn't been registered yet. The token is used in the header of requests that create a user, such as the Accept Invite API route.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#1-basic-authentication-flow
url: https://docs.medusajs.com/resources/commerce-modules/auth/authentication-route#1-basic-authentication-flow
description: Learn about the basic authentication flow.
x-authenticated: false
parameters:
@@ -59377,7 +59377,7 @@ paths:
Use the generated token to update the user's password using the [Reset Password API route](https://docs.medusajs.com/api/admin#auth_postactor_typeauth_providerupdate).
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#generate-reset-password-token-route
url: https://docs.medusajs.com/resources/commerce-modules/auth/authentication-route#generate-reset-password-token-route
description: Learn more about this API route.
x-authenticated: false
parameters:
@@ -59467,7 +59467,7 @@ paths:
x-sidebar-summary: Reset Password
description: Reset an admin user's password using a reset-password token generated with the [Generate Reset Password Token API route](https://docs.medusajs.com/api/admin#auth_postactor_typeauth_providerresetpassword). You pass the token as a bearer token in the request's Authorization header.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#reset-password-route
url: https://docs.medusajs.com/resources/commerce-modules/auth/authentication-route#reset-password-route
description: Learn more about this API route.
x-authenticated: true
parameters:
@@ -60888,7 +60888,7 @@ components:
type: array
description: The claim's transactions.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
description: Learn more about transactions of orders and associated models.
items:
$ref: '#/components/schemas/BaseOrderTransaction'
@@ -61539,7 +61539,7 @@ components:
type: object
description: The flat-rate shipping option's data, useful for the fulfillment provider handling its processing.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
price_type:
type: string
description: The shipping option's price type. If `flat`, the shipping option has a fixed price set in `prices`. Otherwise, the shipping option's price is calculated by the fulfillment provider.
@@ -61702,7 +61702,7 @@ components:
type: object
description: Any data useful for the fulfillment provider to handle the fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
description: Learn more about the data property.
packed_at:
type: string
@@ -62992,7 +62992,7 @@ components:
title: is_combinable
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
url: https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
metadata:
type: object
description: The tax rate's metadata, used to store custom key-value pairs.
@@ -63066,7 +63066,7 @@ components:
type: boolean
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
url: https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
metadata:
type: object
description: The default tax rate's metadata, used to store custom key-value pairs.
@@ -64812,7 +64812,7 @@ components:
type: object
description: The data relevant for the fulfillment provider to process this shipment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
url: https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -65201,7 +65201,7 @@ components:
type: array
description: The exchange's transactions.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
items:
$ref: '#/components/schemas/BaseOrderTransaction'
metadata:
@@ -65514,7 +65514,7 @@ components:
type: object
description: The fulfillment's data, useful for the third-party provider handling the fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The fulfillment's metadata, can hold custom key-value pairs.
@@ -67347,7 +67347,7 @@ components:
type: object
description: Data useful for the fulfillment provider handling it. This is taken from the associated shipping option.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
provider_id:
type: string
title: provider_id
@@ -67986,7 +67986,7 @@ components:
type: object
description: The data relevant for the fulfillment provider to process this shipment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
url: https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -68384,7 +68384,7 @@ components:
type: object
description: The shipping method's data, useful for fulfillment provider handling its fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -68479,7 +68479,7 @@ components:
type: object
description: The payment's data, useful for processing by the payment provider.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment#whats-a-payment
url: https://docs.medusajs.com/resources/commerce-modules/payment/payment#whats-a-payment
created_at:
type: string
format: date-time
@@ -68662,7 +68662,7 @@ components:
type: object
description: The payment session's data, useful for the payment provider processing the payment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment-session#data-property
url: https://docs.medusajs.com/resources/commerce-modules/payment/payment-session#data-property
context:
type: object
description: The context around the payment, such as the customer's details.
@@ -71628,7 +71628,7 @@ components:
type: object
description: The shipping option's data, useful for the fulfillment provider handling fulfillments created from this option.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping option's metadata, can hold custom key-value pairs.
@@ -72556,7 +72556,7 @@ components:
title: is_combinable
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
url: https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
is_default:
type: boolean
title: is_default
@@ -74395,7 +74395,7 @@ components:
title: is_combinable
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
url: https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
metadata:
type: object
description: The tax rate's metadata, can hold custom key-value pairs.
@@ -76449,7 +76449,7 @@ components:
type: object
description: Data useful for the fulfillment provider handling it. This is taken from the associated shipping option.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
provider_id:
type: string
title: provider_id
@@ -76995,7 +76995,7 @@ components:
type: object
description: The shipping method's data, useful for fulfillment provider handling its fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -77310,7 +77310,7 @@ components:
type: object
description: The payment's data, useful for processing by the payment provider.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment#whats-a-payment
url: https://docs.medusajs.com/resources/commerce-modules/payment/payment#whats-a-payment
created_at:
type: string
format: date-time
@@ -79763,7 +79763,7 @@ components:
type: array
description: The claim's transactions.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
description: Learn more about transactions of orders and associated models.
items:
$ref: '#/components/schemas/OrderTransaction'
@@ -79928,7 +79928,7 @@ components:
type: array
description: The exchange's transactions.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
items:
$ref: '#/components/schemas/OrderTransaction'
metadata:
@@ -80502,7 +80502,7 @@ components:
type: object
description: The shipping method's data, useful for the fulfillment provider handling the fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
url: https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -81757,7 +81757,7 @@ components:
type: object
description: The shipping method's data, useful for fulfillment handling by third-party services.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/cart/concepts#data-property
url: https://docs.medusajs.com/resources/commerce-modules/cart/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -82047,7 +82047,7 @@ components:
type: object
description: The shipping option's data, useful for the provider handling fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
prices:
type: array
description: The shipping option's prices.
@@ -82774,7 +82774,7 @@ components:
type: object
description: Any data necessary for the payment provider to process the payment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment-session#data-property
url: https://docs.medusajs.com/resources/commerce-modules/payment/payment-session#data-property
description: Learn more about the payment session's data property
x-schemaName: StoreInitializePaymentSession
StoreOrder:
@@ -83163,7 +83163,7 @@ components:
type: object
description: Data useful for the fulfillment provider handling it. This is taken from the associated shipping option.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
provider_id:
type: string
title: provider_id
@@ -87337,7 +87337,7 @@ components:
type: object
description: The shipping method's data, useful for fulfillment provider handling its fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -89137,7 +89137,7 @@ components:
type: object
description: The payment session's data, useful for the payment provider processing the payment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment-session#data-property
url: https://docs.medusajs.com/resources/commerce-modules/payment/payment-session#data-property
context:
type: object
description: The context around the payment, such as the customer's details.
@@ -89923,14 +89923,14 @@ components:
title: manage_inventory
description: Whether Medusa manages the variant's inventory. If disabled, the variant is always considered in stock.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/products/inventory
url: https://docs.medusajs.com/resources/storefront-development/products/inventory
description: 'Storefront guide: How to retrieve a product variant''s inventory details.'
inventory_quantity:
type: number
title: inventory_quantity
description: The variant's inventory quantity. This property is only available if you pass `+variants.inventory_quantity` in the `fields` query parameter.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/products/inventory
url: https://docs.medusajs.com/resources/storefront-development/products/inventory
description: 'Storefront guide: How to retrieve a product variant''s inventory details.'
variant_rank:
type: number
@@ -90314,7 +90314,7 @@ components:
type: object
description: The shipping option's data, useful for the provider handling fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping option's metadata, can hold custom key-value pairs.
@@ -2095,7 +2095,7 @@ post:
providers.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
amount:
oneOf:
- type: string
@@ -879,7 +879,7 @@ post:
description: The promotion's type.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/promotion/concepts#what-is-a-promotion
https://docs.medusajs.com/resources/commerce-modules/promotion/concepts#what-is-a-promotion
enum:
- standard
- buyget
@@ -121,7 +121,7 @@ post:
description: The promotion's type.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/promotion/concepts#what-is-a-promotion
https://docs.medusajs.com/resources/commerce-modules/promotion/concepts#what-is-a-promotion
enum:
- standard
- buyget
@@ -7,7 +7,7 @@ post:
the new user's details, or when you don't want users to re-login every day.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#2-third-party-service-authenticate-flow
https://docs.medusajs.com/resources/commerce-modules/auth/authentication-route#2-third-party-service-authenticate-flow
description: Learn about third-party authentication flow.
x-authenticated: true
x-codeSamples:
@@ -11,7 +11,7 @@ post:
continue authentication with the third-party service.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#types-of-authentication-flows
https://docs.medusajs.com/resources/commerce-modules/auth/authentication-route#types-of-authentication-flows
description: Learn about different authentication flows.
x-authenticated: false
parameters:
@@ -17,7 +17,7 @@ post:
request's Authorization header.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#2-third-party-service-authenticate-flow
https://docs.medusajs.com/resources/commerce-modules/auth/authentication-route#2-third-party-service-authenticate-flow
description: Learn about third-party authentication flow.
x-authenticated: false
parameters:
@@ -7,7 +7,7 @@ post:
user, such as the Accept Invite API route.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#1-basic-authentication-flow
https://docs.medusajs.com/resources/commerce-modules/auth/authentication-route#1-basic-authentication-flow
description: Learn about the basic authentication flow.
x-authenticated: false
parameters:
@@ -22,7 +22,7 @@ post:
Use the generated token to update the user's password using the [Reset Password API route](https://docs.medusajs.com/api/admin#auth_postactor_typeauth_providerupdate).
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#generate-reset-password-token-route
https://docs.medusajs.com/resources/commerce-modules/auth/authentication-route#generate-reset-password-token-route
description: Learn more about this API route.
x-authenticated: false
parameters:
@@ -9,7 +9,7 @@ post:
You pass the token as a bearer token in the request's Authorization header.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/auth/authentication-route#reset-password-route
https://docs.medusajs.com/resources/commerce-modules/auth/authentication-route#reset-password-route
description: Learn more about this API route.
x-authenticated: true
parameters:
@@ -60,8 +60,7 @@ properties:
type: array
description: The claim's transactions.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
description: Learn more about transactions of orders and associated models.
items:
$ref: ./BaseOrderTransaction.yaml
@@ -28,7 +28,7 @@ properties:
handling its processing.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
price_type:
type: string
description: >-
@@ -42,7 +42,7 @@ properties:
description: Any data useful for the fulfillment provider to handle the fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
description: Learn more about the data property.
packed_at:
type: string
@@ -39,7 +39,7 @@ properties:
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
metadata:
type: object
description: The tax rate's metadata, used to store custom key-value pairs.
@@ -47,7 +47,7 @@ properties:
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
metadata:
type: object
description: The default tax rate's metadata, used to store custom key-value pairs.
@@ -353,7 +353,7 @@ properties:
shipment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -59,8 +59,7 @@ properties:
type: array
description: The exchange's transactions.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
items:
$ref: ./BaseOrderTransaction.yaml
metadata:
@@ -73,7 +73,7 @@ properties:
fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The fulfillment's metadata, can hold custom key-value pairs.
@@ -51,7 +51,7 @@ properties:
the associated shipping option.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
provider_id:
type: string
title: provider_id
@@ -355,7 +355,7 @@ properties:
shipment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -56,7 +56,7 @@ properties:
fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -32,7 +32,7 @@ properties:
description: The payment's data, useful for processing by the payment provider.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment#whats-a-payment
https://docs.medusajs.com/resources/commerce-modules/payment/payment#whats-a-payment
created_at:
type: string
format: date-time
@@ -26,7 +26,7 @@ properties:
payment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment-session#data-property
https://docs.medusajs.com/resources/commerce-modules/payment/payment-session#data-property
context:
type: object
description: The context around the payment, such as the customer's details.
@@ -84,7 +84,7 @@ properties:
fulfillments created from this option.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping option's metadata, can hold custom key-value pairs.
@@ -50,7 +50,7 @@ properties:
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
is_default:
type: boolean
title: is_default
@@ -29,7 +29,7 @@ properties:
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
metadata:
type: object
description: The tax rate's metadata, can hold custom key-value pairs.
@@ -51,7 +51,7 @@ properties:
the associated shipping option.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
provider_id:
type: string
title: provider_id
@@ -56,7 +56,7 @@ properties:
fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -32,7 +32,7 @@ properties:
description: The payment's data, useful for processing by the payment provider.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment#whats-a-payment
https://docs.medusajs.com/resources/commerce-modules/payment/payment#whats-a-payment
created_at:
type: string
format: date-time
@@ -56,8 +56,7 @@ properties:
type: array
description: The claim's transactions.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
description: Learn more about transactions of orders and associated models.
items:
$ref: ./OrderTransaction.yaml
@@ -52,8 +52,7 @@ properties:
type: array
description: The exchange's transactions.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
items:
$ref: ./OrderTransaction.yaml
metadata:
@@ -53,7 +53,7 @@ properties:
the fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -45,7 +45,7 @@ properties:
services.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/cart/concepts#data-property
https://docs.medusajs.com/resources/commerce-modules/cart/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -94,7 +94,7 @@ properties:
description: The shipping option's data, useful for the provider handling fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
prices:
type: array
description: The shipping option's prices.
@@ -13,6 +13,6 @@ properties:
description: Any data necessary for the payment provider to process the payment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment-session#data-property
https://docs.medusajs.com/resources/commerce-modules/payment/payment-session#data-property
description: Learn more about the payment session's data property
x-schemaName: StoreInitializePaymentSession
@@ -51,7 +51,7 @@ properties:
the associated shipping option.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
provider_id:
type: string
title: provider_id
@@ -56,7 +56,7 @@ properties:
fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -26,7 +26,7 @@ properties:
payment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment-session#data-property
https://docs.medusajs.com/resources/commerce-modules/payment/payment-session#data-property
context:
type: object
description: The context around the payment, such as the customer's details.
@@ -102,7 +102,7 @@ properties:
is always considered in stock.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/products/inventory
https://docs.medusajs.com/resources/storefront-development/products/inventory
description: 'Storefront guide: How to retrieve a product variant''s inventory details.'
inventory_quantity:
type: number
@@ -112,7 +112,7 @@ properties:
pass `+variants.inventory_quantity` in the `fields` query parameter.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/products/inventory
https://docs.medusajs.com/resources/storefront-development/products/inventory
description: 'Storefront guide: How to retrieve a product variant''s inventory details.'
variant_rank:
type: number
@@ -66,7 +66,7 @@ properties:
description: The shipping option's data, useful for the provider handling fulfillment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping option's metadata, can hold custom key-value pairs.
@@ -182,7 +182,7 @@ paths:
When used with a third-party provider, such as Google, the request returns a `location` property. You redirect to the specified URL in your storefront to continue authentication with the third-party service.
externalDocs:
url: https://docs.medusajs.com/v2/storefront-development/customers/login#1-using-a-jwt-token
url: https://docs.medusajs.com/resources/storefront-development/customers/login#1-using-a-jwt-token
description: 'Storefront development: How to login as a customer'
x-authenticated: false
parameters:
@@ -274,7 +274,7 @@ paths:
This API route is used by your storefront or frontend application when a third-party provider redirects to it after authentication. It validates the authentication with the third-party provider and, if successful, returns an authentication token. All query parameters received from the third-party provider, such as `code`, `state`, and `error`, must be passed as query parameters to this route.
You can decode the JWT token using libraries like [react-jwt](https://www.npmjs.com/package/react-jwt) in the storefront. If the decoded data doesn't have an `actor_id` property, then you must register the customer using the Create Customer API route passing the token in the request's Authorization header.
externalDocs:
url: https://docs.medusajs.com/v2/storefront-development/customers/third-party-login
url: https://docs.medusajs.com/resources/storefront-development/customers/third-party-login
description: 'Storefront development: Implement third-party (social) login.'
x-authenticated: false
parameters:
@@ -375,7 +375,7 @@ paths:
summary: Retrieve Registration JWT Token
description: This API route retrieves a registration JWT token of a customer that hasn't been registered yet. The token is used in the header of requests that create a customer.
externalDocs:
url: https://docs.medusajs.com/v2/storefront-development/customers/register
url: https://docs.medusajs.com/resources/storefront-development/customers/register
description: 'Storefront development: How to register a customer'
x-authenticated: false
parameters:
@@ -471,7 +471,7 @@ paths:
Use the generated token to update the customer's password using the [Reset Password API route](https://docs.medusajs.com/api/store#auth_postactor_typeauth_providerupdate).
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/customers/reset-password#1-request-reset-password-page
url: https://docs.medusajs.com/resources/storefront-development/customers/reset-password#1-request-reset-password-page
description: 'Storefront development: How to create the request reset password page.'
x-authenticated: false
parameters:
@@ -565,7 +565,7 @@ paths:
x-sidebar-summary: Reset Password
description: Reset a customer's password using a reset-password token generated with the [Generate Reset Password Token API route](https://docs.medusajs.com/api/store#auth_postactor_typeauth_providerresetpassword). You pass the token as a bearer token in the request's Authorization header.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/customers/reset-password#2-reset-password-page
url: https://docs.medusajs.com/resources/storefront-development/customers/reset-password#2-reset-password-page
description: 'Storefront development: How to create the reset password page.'
x-authenticated: true
parameters:
@@ -662,7 +662,7 @@ paths:
summary: Set Authentication Session
description: Set the cookie session ID of a customer. The customer must be previously authenticated with the `/auth/customer/{provider}` API route first, as the JWT token is required in the header of the request.
externalDocs:
url: https://docs.medusajs.com/v2/storefront-development/customers/login#2-using-a-cookie-session
url: https://docs.medusajs.com/resources/storefront-development/customers/login#2-using-a-cookie-session
description: 'Storefront development: How to login as a customer'
x-authenticated: true
x-codeSamples:
@@ -759,7 +759,7 @@ paths:
summary: Refresh Authentication Token
description: Refresh the authentication token of a customer. This is useful after authenticating a customer with a third-party service to ensure the token holds the new user's details, or when you don't want customers to re-login every day.
externalDocs:
url: https://docs.medusajs.com/v2/storefront-development/customers/third-party-login
url: https://docs.medusajs.com/resources/storefront-development/customers/third-party-login
description: 'Storefront development: Implement third-party (social) login.'
x-authenticated: true
x-codeSamples:
@@ -1120,7 +1120,7 @@ paths:
description: Complete a cart and place an order.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/checkout/complete-cart
url: https://docs.medusajs.com/resources/storefront-development/checkout/complete-cart
description: 'Storefront guide: How to implement cart completion during checkout.'
parameters:
- name: id
@@ -1236,7 +1236,7 @@ paths:
type: string
title: type
description: |
The error's type. Can be a [MedusaError type](https://docs.medusajs.com/v2/advanced-development/api-routes/errors#medusaerror-types) or `payment_authorization_error` or `payment_requires_more_error` for payment-related errors.
The error's type. Can be a [MedusaError type](https://docs.medusajs.com/learn/fundamentals/api-routes/errors#medusaerror-types) or `payment_authorization_error` or `payment_requires_more_error` for payment-related errors.
'400':
$ref: '#/components/responses/400_error'
'401':
@@ -1534,7 +1534,7 @@ paths:
x-sidebar-summary: Add Line Item
description: Add a product variant as a line item in the cart.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/cart/manage-items#add-product-variant-to-cart
url: https://docs.medusajs.com/resources/storefront-development/cart/manage-items#add-product-variant-to-cart
description: 'Storefront guide: How to add a product variant to the cart.'
x-authenticated: false
parameters:
@@ -1666,7 +1666,7 @@ paths:
x-sidebar-summary: Update Line Item
description: Update a line item's details in the cart.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/cart/manage-items#update-line-item-in-cart
url: https://docs.medusajs.com/resources/storefront-development/cart/manage-items#update-line-item-in-cart
description: 'Storefront guide: How to update a cart''s line item.'
x-authenticated: false
parameters:
@@ -1800,7 +1800,7 @@ paths:
x-sidebar-summary: Remove Line Item
description: Remove a line item from a cart.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/cart/manage-items#remove-line-item-from-cart
url: https://docs.medusajs.com/resources/storefront-development/cart/manage-items#remove-line-item-from-cart
description: 'Storefront guide: How to remove line item from cart.'
x-authenticated: false
parameters:
@@ -1922,7 +1922,7 @@ paths:
description: Add a list of promotions to a cart.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/cart/manage-promotions#add-promotion-to-cart
url: https://docs.medusajs.com/resources/storefront-development/cart/manage-promotions#add-promotion-to-cart
description: 'Storefront guide: How to add a promotion to cart.'
parameters:
- name: id
@@ -1995,7 +1995,7 @@ paths:
description: Remove a list of promotions from a cart.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/cart/manage-promotions#remove-promotion-from-cart
url: https://docs.medusajs.com/resources/storefront-development/cart/manage-promotions#remove-promotion-from-cart
description: 'Storefront guide: How to remove a promotion from cart.'
parameters:
- name: id
@@ -2073,7 +2073,7 @@ paths:
x-sidebar-summary: Add Shipping Method
description: Add a shipping method to a cart. Use this API route when the customer chooses their preferred shipping option.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/checkout/shipping
url: https://docs.medusajs.com/resources/storefront-development/checkout/shipping
description: 'Storefront guide: How to implement shipping during checkout.'
x-authenticated: false
parameters:
@@ -2340,7 +2340,7 @@ paths:
description: Retrieve a list of collections. The collections can be filtered by fields such as `handle`. The collections can also be sorted or paginated.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/products/collections/list
url: https://docs.medusajs.com/resources/storefront-development/products/collections/list
description: 'Storefront guide: How to retrieve a list of collections.'
parameters:
- name: x-publishable-api-key
@@ -3013,7 +3013,7 @@ paths:
description: Retrieve a collection by its ID. You can expand the collection's relations or select the fields that should be returned.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/products/collections/retrieve
url: https://docs.medusajs.com/resources/storefront-development/products/collections/retrieve
description: 'Storefront guide: How to retrieve a collection.'
parameters:
- name: id
@@ -3282,7 +3282,7 @@ paths:
summary: Register Customer
description: Register a customer. Use the `/auth/customer/emailpass/register` API route first to retrieve the registration token and pass it in the header of the request.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/customers/register
url: https://docs.medusajs.com/resources/storefront-development/customers/register
description: 'Storefront guide: How to register a customer.'
x-authenticated: true
parameters:
@@ -3401,7 +3401,7 @@ paths:
description: Retrieve the logged-in customer. You can expand the customer's relations or select the fields that should be returned.
x-authenticated: true
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/customers/retrieve
url: https://docs.medusajs.com/resources/storefront-development/customers/retrieve
description: 'Storefront guide: How to retrieve the logged-in customer.'
parameters:
- name: x-publishable-api-key
@@ -3480,7 +3480,7 @@ paths:
summary: Update Customer
description: Update the logged-in customer's details.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/customers/profile
url: https://docs.medusajs.com/resources/storefront-development/customers/profile
description: 'Storefront guide: How to edit a customer''s profile.'
x-authenticated: true
parameters:
@@ -3588,7 +3588,7 @@ paths:
description: Retrieve the addresses of the logged-in customer. The addresses can be filtered by fields such as `country_code`. The addresses can also be sorted or paginated.
x-authenticated: true
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/customers/addresses#list-customer-addresses
url: https://docs.medusajs.com/resources/storefront-development/customers/addresses#list-customer-addresses
description: 'Storefront guide: How to retrieve the logged-in customer''s addresses.'
parameters:
- name: x-publishable-api-key
@@ -3759,7 +3759,7 @@ paths:
x-sidebar-summary: Create Address
description: Create an address for the logged-in customer.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/customers/addresses#add-customer-address
url: https://docs.medusajs.com/resources/storefront-development/customers/addresses#add-customer-address
description: 'Storefront guide: How to create an address for the logged-in customer.'
x-authenticated: true
parameters:
@@ -3951,7 +3951,7 @@ paths:
x-sidebar-summary: Update Address
description: Update the logged-in customer's address.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/customers/addresses#edit-an-address
url: https://docs.medusajs.com/resources/storefront-development/customers/addresses#edit-an-address
description: 'Storefront guide: How to update an address of the logged-in customer.'
x-authenticated: true
parameters:
@@ -4055,7 +4055,7 @@ paths:
description: Remove an address of the logged-in customer.
x-authenticated: true
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/customers/addresses#delete-customer-address
url: https://docs.medusajs.com/resources/storefront-development/customers/addresses#delete-customer-address
description: 'Storefront guide: How to delete a customer''s address.'
parameters:
- name: address_id
@@ -5003,7 +5003,7 @@ paths:
summary: Create Payment Collection
description: Create a payment collection for a cart. This is used during checkout, where the payment collection holds the cart's payment sessions.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/checkout/payment
url: https://docs.medusajs.com/resources/storefront-development/checkout/payment
description: 'Storefront guide: How to implement payment during checkout.'
x-authenticated: false
parameters:
@@ -5103,7 +5103,7 @@ paths:
In cases where you want to create a payment session for a payment collection with an amount of `0`, you can use the Manual System Payment Provider instead of third-party payment providers. The Manual System Payment Provider is built into Medusa and allows you to create payment sessions without interacting with an external payment provider.
Make sure to configure the Manual System Payment Provider in your store's region. Learn more in the [Manage Region](https://docs.medusajs.com/user-guide/settings/regions#edit-region-details) user guide.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/checkout/payment
url: https://docs.medusajs.com/resources/storefront-development/checkout/payment
description: 'Storefront guide: How to implement payment during checkout.'
x-authenticated: false
parameters:
@@ -5176,7 +5176,7 @@ paths:
description: Retrieve a list of payment providers. You must provide the `region_id` query parameter to retrieve the payment providers enabled in that region.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/checkout/payment
url: https://docs.medusajs.com/resources/storefront-development/checkout/payment
description: 'Storefront guide: How to implement payment during checkout.'
parameters:
- name: x-publishable-api-key
@@ -5327,7 +5327,7 @@ paths:
description: Retrieve a list of product categories. The product categories can be filtered by fields such as `id`. The product categories can also be sorted or paginated.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/products/categories/list
url: https://docs.medusajs.com/resources/storefront-development/products/categories/list
description: 'Storefront guide: How to retrieve a list of product categories.'
parameters:
- name: x-publishable-api-key
@@ -6013,7 +6013,7 @@ paths:
description: Retrieve a product category by its ID. You can expand the product category's relations or select the fields that should be returned.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/products/categories/retrieve
url: https://docs.medusajs.com/resources/storefront-development/products/categories/retrieve
description: 'Storefront guide: How to retrieve a product category.'
parameters:
- name: id
@@ -7455,7 +7455,7 @@ paths:
description: Retrieve a list of products. The products can be filtered by fields such as `id`. The products can also be sorted or paginated.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/products/price
url: https://docs.medusajs.com/resources/storefront-development/products/price
description: 'Storefront guide: How to retrieve a product variants'' prices.'
parameters:
- name: x-publishable-api-key
@@ -7591,7 +7591,7 @@ paths:
schema:
description: Filter by a collection's ID to retrieve the products in it.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/products/collections/products
url: https://docs.medusajs.com/resources/storefront-development/products/collections/products
description: 'Storefront guide: Retrieve a collection''s products.'
items:
type: string
@@ -8098,7 +8098,7 @@ paths:
title: region_id
description: The ID of the region the products are being viewed from. This is required if you're retrieving product variant prices with taxes.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/products/price/examples/tax-price
url: https://docs.medusajs.com/resources/storefront-development/products/price/examples/tax-price
description: 'Storefront guide: How to show product variants'' prices with taxes.'
- name: province
in: query
@@ -8264,7 +8264,7 @@ paths:
description: Retrieve a product by its ID. You can expand the product's relations or select the fields that should be returned.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/products/price
url: https://docs.medusajs.com/resources/storefront-development/products/price
description: 'Storefront guide: How to retrieve a product variants'' prices.'
parameters:
- name: id
@@ -8300,7 +8300,7 @@ paths:
title: region_id
description: The ID of the region the product is being viewed from. This is required if you're retrieving product variant prices with taxes.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/products/price/examples/tax-price
url: https://docs.medusajs.com/resources/storefront-development/products/price/examples/tax-price
description: 'Storefront guide: How to show product variants'' prices with taxes.'
- name: country_code
in: query
@@ -8385,7 +8385,7 @@ paths:
description: Retrieve a list of regions. The regions can be filtered by fields such as `id`. The regions can also be sorted or paginated.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/regions/list
url: https://docs.medusajs.com/resources/storefront-development/regions/list
description: 'Storefront guide: How to retrieve a list of regions.'
parameters:
- name: x-publishable-api-key
@@ -8944,7 +8944,7 @@ paths:
The shipping options also be sorted or paginated.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/checkout/shipping
url: https://docs.medusajs.com/resources/storefront-development/checkout/shipping
description: 'Storefront guide: How to implement shipping during checkout.'
x-authenticated: false
parameters:
@@ -10952,7 +10952,7 @@ components:
type: array
description: The claim's transactions.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
description: Learn more about transactions of orders and associated models.
items:
$ref: '#/components/schemas/BaseOrderTransaction'
@@ -11603,7 +11603,7 @@ components:
type: object
description: The flat-rate shipping option's data, useful for the fulfillment provider handling its processing.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
price_type:
type: string
description: The shipping option's price type. If `flat`, the shipping option has a fixed price set in `prices`. Otherwise, the shipping option's price is calculated by the fulfillment provider.
@@ -11766,7 +11766,7 @@ components:
type: object
description: Any data useful for the fulfillment provider to handle the fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
description: Learn more about the data property.
packed_at:
type: string
@@ -13056,7 +13056,7 @@ components:
title: is_combinable
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
url: https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
metadata:
type: object
description: The tax rate's metadata, used to store custom key-value pairs.
@@ -13130,7 +13130,7 @@ components:
type: boolean
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
url: https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
metadata:
type: object
description: The default tax rate's metadata, used to store custom key-value pairs.
@@ -14876,7 +14876,7 @@ components:
type: object
description: The data relevant for the fulfillment provider to process this shipment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
url: https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -15265,7 +15265,7 @@ components:
type: array
description: The exchange's transactions.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
items:
$ref: '#/components/schemas/BaseOrderTransaction'
metadata:
@@ -15578,7 +15578,7 @@ components:
type: object
description: The fulfillment's data, useful for the third-party provider handling the fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The fulfillment's metadata, can hold custom key-value pairs.
@@ -17411,7 +17411,7 @@ components:
type: object
description: Data useful for the fulfillment provider handling it. This is taken from the associated shipping option.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
provider_id:
type: string
title: provider_id
@@ -18050,7 +18050,7 @@ components:
type: object
description: The data relevant for the fulfillment provider to process this shipment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
url: https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -18448,7 +18448,7 @@ components:
type: object
description: The shipping method's data, useful for fulfillment provider handling its fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -18543,7 +18543,7 @@ components:
type: object
description: The payment's data, useful for processing by the payment provider.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment#whats-a-payment
url: https://docs.medusajs.com/resources/commerce-modules/payment/payment#whats-a-payment
created_at:
type: string
format: date-time
@@ -18726,7 +18726,7 @@ components:
type: object
description: The payment session's data, useful for the payment provider processing the payment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment-session#data-property
url: https://docs.medusajs.com/resources/commerce-modules/payment/payment-session#data-property
context:
type: object
description: The context around the payment, such as the customer's details.
@@ -21692,7 +21692,7 @@ components:
type: object
description: The shipping option's data, useful for the fulfillment provider handling fulfillments created from this option.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping option's metadata, can hold custom key-value pairs.
@@ -22620,7 +22620,7 @@ components:
title: is_combinable
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
url: https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
is_default:
type: boolean
title: is_default
@@ -24459,7 +24459,7 @@ components:
title: is_combinable
description: Whether the tax rate should be combined with parent rates.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
url: https://docs.medusajs.com/resources/commerce-modules/tax/tax-rates-and-rules#combinable-tax-rates
metadata:
type: object
description: The tax rate's metadata, can hold custom key-value pairs.
@@ -26513,7 +26513,7 @@ components:
type: object
description: Data useful for the fulfillment provider handling it. This is taken from the associated shipping option.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
provider_id:
type: string
title: provider_id
@@ -27059,7 +27059,7 @@ components:
type: object
description: The shipping method's data, useful for fulfillment provider handling its fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -27374,7 +27374,7 @@ components:
type: object
description: The payment's data, useful for processing by the payment provider.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment#whats-a-payment
url: https://docs.medusajs.com/resources/commerce-modules/payment/payment#whats-a-payment
created_at:
type: string
format: date-time
@@ -29827,7 +29827,7 @@ components:
type: array
description: The claim's transactions.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
description: Learn more about transactions of orders and associated models.
items:
$ref: '#/components/schemas/OrderTransaction'
@@ -29992,7 +29992,7 @@ components:
type: array
description: The exchange's transactions.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/transactions
url: https://docs.medusajs.com/resources/commerce-modules/order/transactions
items:
$ref: '#/components/schemas/OrderTransaction'
metadata:
@@ -30566,7 +30566,7 @@ components:
type: object
description: The shipping method's data, useful for the fulfillment provider handling the fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/order/concepts#data-property
url: https://docs.medusajs.com/resources/commerce-modules/order/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -31821,7 +31821,7 @@ components:
type: object
description: The shipping method's data, useful for fulfillment handling by third-party services.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/cart/concepts#data-property
url: https://docs.medusajs.com/resources/commerce-modules/cart/concepts#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -32111,7 +32111,7 @@ components:
type: object
description: The shipping option's data, useful for the provider handling fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
prices:
type: array
description: The shipping option's prices.
@@ -32838,7 +32838,7 @@ components:
type: object
description: Any data necessary for the payment provider to process the payment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment-session#data-property
url: https://docs.medusajs.com/resources/commerce-modules/payment/payment-session#data-property
description: Learn more about the payment session's data property
x-schemaName: StoreInitializePaymentSession
StoreOrder:
@@ -33227,7 +33227,7 @@ components:
type: object
description: Data useful for the fulfillment provider handling it. This is taken from the associated shipping option.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
provider_id:
type: string
title: provider_id
@@ -37401,7 +37401,7 @@ components:
type: object
description: The shipping method's data, useful for fulfillment provider handling its fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping method's metadata, can hold custom key-value pairs.
@@ -39201,7 +39201,7 @@ components:
type: object
description: The payment session's data, useful for the payment provider processing the payment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment-session#data-property
url: https://docs.medusajs.com/resources/commerce-modules/payment/payment-session#data-property
context:
type: object
description: The context around the payment, such as the customer's details.
@@ -39987,14 +39987,14 @@ components:
title: manage_inventory
description: Whether Medusa manages the variant's inventory. If disabled, the variant is always considered in stock.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/products/inventory
url: https://docs.medusajs.com/resources/storefront-development/products/inventory
description: 'Storefront guide: How to retrieve a product variant''s inventory details.'
inventory_quantity:
type: number
title: inventory_quantity
description: The variant's inventory quantity. This property is only available if you pass `+variants.inventory_quantity` in the `fields` query parameter.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/products/inventory
url: https://docs.medusajs.com/resources/storefront-development/products/inventory
description: 'Storefront guide: How to retrieve a product variant''s inventory details.'
variant_rank:
type: number
@@ -40378,7 +40378,7 @@ components:
type: object
description: The shipping option's data, useful for the provider handling fulfillment.
externalDocs:
url: https://docs.medusajs.com/v2/resources/commerce-modules/fulfillment/shipping-option#data-property
url: https://docs.medusajs.com/resources/commerce-modules/fulfillment/shipping-option#data-property
metadata:
type: object
description: The shipping option's metadata, can hold custom key-value pairs.
@@ -11,7 +11,7 @@ post:
continue authentication with the third-party service.
externalDocs:
url: >-
https://docs.medusajs.com/v2/storefront-development/customers/login#1-using-a-jwt-token
https://docs.medusajs.com/resources/storefront-development/customers/login#1-using-a-jwt-token
description: 'Storefront development: How to login as a customer'
x-authenticated: false
parameters:
@@ -16,7 +16,7 @@ post:
in the request's Authorization header.
externalDocs:
url: >-
https://docs.medusajs.com/v2/storefront-development/customers/third-party-login
https://docs.medusajs.com/resources/storefront-development/customers/third-party-login
description: 'Storefront development: Implement third-party (social) login.'
x-authenticated: false
parameters:
@@ -6,7 +6,8 @@ post:
been registered yet. The token is used in the header of requests that create
a customer.
externalDocs:
url: https://docs.medusajs.com/v2/storefront-development/customers/register
url: >-
https://docs.medusajs.com/resources/storefront-development/customers/register
description: 'Storefront development: How to register a customer'
x-authenticated: false
parameters:
@@ -21,7 +21,7 @@ post:
Use the generated token to update the customer's password using the [Reset Password API route](https://docs.medusajs.com/api/store#auth_postactor_typeauth_providerupdate).
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/customers/reset-password#1-request-reset-password-page
https://docs.medusajs.com/resources/storefront-development/customers/reset-password#1-request-reset-password-page
description: 'Storefront development: How to create the request reset password page.'
x-authenticated: false
parameters:
@@ -9,7 +9,7 @@ post:
You pass the token as a bearer token in the request's Authorization header.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/customers/reset-password#2-reset-password-page
https://docs.medusajs.com/resources/storefront-development/customers/reset-password#2-reset-password-page
description: 'Storefront development: How to create the reset password page.'
x-authenticated: true
parameters:
@@ -7,7 +7,7 @@ post:
JWT token is required in the header of the request.
externalDocs:
url: >-
https://docs.medusajs.com/v2/storefront-development/customers/login#2-using-a-cookie-session
https://docs.medusajs.com/resources/storefront-development/customers/login#2-using-a-cookie-session
description: 'Storefront development: How to login as a customer'
x-authenticated: true
x-codeSamples:
@@ -8,7 +8,7 @@ post:
every day.
externalDocs:
url: >-
https://docs.medusajs.com/v2/storefront-development/customers/third-party-login
https://docs.medusajs.com/resources/storefront-development/customers/third-party-login
description: 'Storefront development: Implement third-party (social) login.'
x-authenticated: true
x-codeSamples:
@@ -5,7 +5,7 @@ post:
x-authenticated: false
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/checkout/complete-cart
https://docs.medusajs.com/resources/storefront-development/checkout/complete-cart
description: 'Storefront guide: How to implement cart completion during checkout.'
parameters:
- name: id
@@ -110,7 +110,7 @@ post:
title: type
description: >
The error's type. Can be a [MedusaError
type](https://docs.medusajs.com/v2/advanced-development/api-routes/errors#medusaerror-types)
type](https://docs.medusajs.com/learn/fundamentals/api-routes/errors#medusaerror-types)
or `payment_authorization_error` or
`payment_requires_more_error` for payment-related
errors.
@@ -5,7 +5,7 @@ post:
description: Add a product variant as a line item in the cart.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/cart/manage-items#add-product-variant-to-cart
https://docs.medusajs.com/resources/storefront-development/cart/manage-items#add-product-variant-to-cart
description: 'Storefront guide: How to add a product variant to the cart.'
x-authenticated: false
parameters:
@@ -5,7 +5,7 @@ post:
description: Update a line item's details in the cart.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/cart/manage-items#update-line-item-in-cart
https://docs.medusajs.com/resources/storefront-development/cart/manage-items#update-line-item-in-cart
description: 'Storefront guide: How to update a cart''s line item.'
x-authenticated: false
parameters:
@@ -123,7 +123,7 @@ delete:
description: Remove a line item from a cart.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/cart/manage-items#remove-line-item-from-cart
https://docs.medusajs.com/resources/storefront-development/cart/manage-items#remove-line-item-from-cart
description: 'Storefront guide: How to remove line item from cart.'
x-authenticated: false
parameters:
@@ -6,7 +6,7 @@ post:
x-authenticated: false
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/cart/manage-promotions#add-promotion-to-cart
https://docs.medusajs.com/resources/storefront-development/cart/manage-promotions#add-promotion-to-cart
description: 'Storefront guide: How to add a promotion to cart.'
parameters:
- name: id
@@ -81,7 +81,7 @@ delete:
x-authenticated: false
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/cart/manage-promotions#remove-promotion-from-cart
https://docs.medusajs.com/resources/storefront-development/cart/manage-promotions#remove-promotion-from-cart
description: 'Storefront guide: How to remove a promotion from cart.'
parameters:
- name: id
@@ -7,7 +7,7 @@ post:
chooses their preferred shipping option.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/checkout/shipping
https://docs.medusajs.com/resources/storefront-development/checkout/shipping
description: 'Storefront guide: How to implement shipping during checkout.'
x-authenticated: false
parameters:
@@ -7,7 +7,7 @@ get:
x-authenticated: false
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/products/collections/list
https://docs.medusajs.com/resources/storefront-development/products/collections/list
description: 'Storefront guide: How to retrieve a list of collections.'
parameters:
- name: x-publishable-api-key
@@ -7,7 +7,7 @@ get:
x-authenticated: false
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/products/collections/retrieve
https://docs.medusajs.com/resources/storefront-development/products/collections/retrieve
description: 'Storefront guide: How to retrieve a collection.'
parameters:
- name: id
@@ -7,7 +7,7 @@ post:
request.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/customers/register
https://docs.medusajs.com/resources/storefront-development/customers/register
description: 'Storefront guide: How to register a customer.'
x-authenticated: true
parameters:
@@ -8,7 +8,7 @@ get:
x-authenticated: true
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/customers/retrieve
https://docs.medusajs.com/resources/storefront-development/customers/retrieve
description: 'Storefront guide: How to retrieve the logged-in customer.'
parameters:
- name: x-publishable-api-key
@@ -84,7 +84,7 @@ post:
description: Update the logged-in customer's details.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/customers/profile
https://docs.medusajs.com/resources/storefront-development/customers/profile
description: 'Storefront guide: How to edit a customer''s profile.'
x-authenticated: true
parameters:
@@ -9,7 +9,7 @@ get:
x-authenticated: true
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/customers/addresses#list-customer-addresses
https://docs.medusajs.com/resources/storefront-development/customers/addresses#list-customer-addresses
description: 'Storefront guide: How to retrieve the logged-in customer''s addresses.'
parameters:
- name: x-publishable-api-key
@@ -169,7 +169,7 @@ post:
description: Create an address for the logged-in customer.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/customers/addresses#add-customer-address
https://docs.medusajs.com/resources/storefront-development/customers/addresses#add-customer-address
description: 'Storefront guide: How to create an address for the logged-in customer.'
x-authenticated: true
parameters:
@@ -88,7 +88,7 @@ post:
description: Update the logged-in customer's address.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/customers/addresses#edit-an-address
https://docs.medusajs.com/resources/storefront-development/customers/addresses#edit-an-address
description: 'Storefront guide: How to update an address of the logged-in customer.'
x-authenticated: true
parameters:
@@ -182,7 +182,7 @@ delete:
x-authenticated: true
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/customers/addresses#delete-customer-address
https://docs.medusajs.com/resources/storefront-development/customers/addresses#delete-customer-address
description: 'Storefront guide: How to delete a customer''s address.'
parameters:
- name: address_id
@@ -6,7 +6,7 @@ post:
the payment collection holds the cart's payment sessions.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/checkout/payment
https://docs.medusajs.com/resources/storefront-development/checkout/payment
description: 'Storefront guide: How to implement payment during checkout.'
x-authenticated: false
parameters:
@@ -25,7 +25,7 @@ post:
user guide.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/checkout/payment
https://docs.medusajs.com/resources/storefront-development/checkout/payment
description: 'Storefront guide: How to implement payment during checkout.'
x-authenticated: false
parameters:
@@ -7,7 +7,7 @@ get:
x-authenticated: false
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/checkout/payment
https://docs.medusajs.com/resources/storefront-development/checkout/payment
description: 'Storefront guide: How to implement payment during checkout.'
parameters:
- name: x-publishable-api-key
@@ -8,7 +8,7 @@ get:
x-authenticated: false
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/products/categories/list
https://docs.medusajs.com/resources/storefront-development/products/categories/list
description: 'Storefront guide: How to retrieve a list of product categories.'
parameters:
- name: x-publishable-api-key
@@ -7,7 +7,7 @@ get:
x-authenticated: false
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/products/categories/retrieve
https://docs.medusajs.com/resources/storefront-development/products/categories/retrieve
description: 'Storefront guide: How to retrieve a product category.'
parameters:
- name: id
@@ -6,8 +6,7 @@ get:
`id`. The products can also be sorted or paginated.
x-authenticated: false
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/products/price
url: https://docs.medusajs.com/resources/storefront-development/products/price
description: 'Storefront guide: How to retrieve a product variants'' prices.'
parameters:
- name: x-publishable-api-key
@@ -165,7 +164,7 @@ get:
description: Filter by a collection's ID to retrieve the products in it.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/products/collections/products
https://docs.medusajs.com/resources/storefront-development/products/collections/products
description: 'Storefront guide: Retrieve a collection''s products.'
items:
type: string
@@ -753,7 +752,7 @@ get:
required if you're retrieving product variant prices with taxes.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/products/price/examples/tax-price
https://docs.medusajs.com/resources/storefront-development/products/price/examples/tax-price
description: 'Storefront guide: How to show product variants'' prices with taxes.'
- name: province
in: query
@@ -6,8 +6,7 @@ get:
select the fields that should be returned.
x-authenticated: false
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/products/price
url: https://docs.medusajs.com/resources/storefront-development/products/price
description: 'Storefront guide: How to retrieve a product variants'' prices.'
parameters:
- name: id
@@ -56,7 +55,7 @@ get:
required if you're retrieving product variant prices with taxes.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/products/price/examples/tax-price
https://docs.medusajs.com/resources/storefront-development/products/price/examples/tax-price
description: 'Storefront guide: How to show product variants'' prices with taxes.'
- name: country_code
in: query
@@ -6,7 +6,7 @@ get:
`id`. The regions can also be sorted or paginated.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/regions/list
url: https://docs.medusajs.com/resources/storefront-development/regions/list
description: 'Storefront guide: How to retrieve a list of regions.'
parameters:
- name: x-publishable-api-key
@@ -9,7 +9,7 @@ get:
The shipping options also be sorted or paginated.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/checkout/shipping
https://docs.medusajs.com/resources/storefront-development/checkout/shipping
description: 'Storefront guide: How to implement shipping during checkout.'
x-authenticated: false
parameters: