Files
medusa-store/www/apps/api-reference/specs/admin/openapi.yaml
github-actions[bot] 83bfad386e chore(docs): Updated API Reference (v2) (#8714)
Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action
2024-08-22 08:52:13 +00:00

547 lines
22 KiB
YAML

openapi: 3.0.0
info:
version: 2.0.0
title: Medusa Admin API
license:
name: MIT
url: https://github.com/medusajs/medusa/blob/master/LICENSE
servers:
- url: http://localhost:9000
- url: https://api.medusa-commerce.com
tags:
- name: Api Keys
- name: Campaigns
- name: Claims
x-associatedSchema:
$ref: ./components/schemas/AdminClaim.yaml
- name: Collections
x-associatedSchema:
$ref: ./components/schemas/AdminCollection.yaml
- name: Currencies
description: >
A store can use unlimited currencies, and each region must be associated
with at least one currency.
Currencies are defined within the Medusa backend. Currency API Routes
allow admins to list and update currencies.
externalDocs:
description: How to manage currencies
url: >-
https://docs.medusajs.com/modules/regions-and-currencies/admin/manage-currencies
x-associatedSchema:
$ref: ./components/schemas/AdminCurrency.yaml
- name: Customer Groups
x-associatedSchema:
$ref: ./components/schemas/AdminCustomerGroup.yaml
- name: Customers
description: >
Customers can either be created when they register through the Store APIs,
or created by the admin using the Admin APIs.
externalDocs:
description: How to manage customers
url: https://docs.medusajs.com/modules/customers/admin/manage-customers
x-associatedSchema:
$ref: ./components/schemas/AdminCustomer.yaml
- name: Draft Orders
- name: Exchanges
x-associatedSchema:
$ref: ./components/schemas/AdminExchange.yaml
- name: Fulfillment Providers
x-associatedSchema:
$ref: ./components/schemas/AdminFulfillmentProvider.yaml
- name: Fulfillment Sets
x-associatedSchema:
$ref: ./components/schemas/AdminFulfillmentSet.yaml
- name: Fulfillments
x-associatedSchema:
$ref: ./components/schemas/AdminFulfillment.yaml
- name: Inventory Items
x-associatedSchema:
$ref: ./components/schemas/AdminInventoryItem.yaml
- name: Invites
description: >
An admin can invite new users to manage their team. This would allow new
users to authenticate as admins and perform admin functionalities.
externalDocs:
description: How to manage invites
url: https://docs.medusajs.com/modules/users/admin/manage-invites
x-associatedSchema:
$ref: ./components/schemas/AdminInvite.yaml
- name: Notifications
x-associatedSchema:
$ref: ./components/schemas/AdminNotification.yaml
- name: Order Edits
- name: Orders
x-associatedSchema:
$ref: ./components/schemas/AdminOrder.yaml
- name: Payment Collections
x-associatedSchema:
$ref: ./components/schemas/AdminPaymentCollection.yaml
- name: Payments
x-associatedSchema:
$ref: ./components/schemas/AdminPayment.yaml
- name: Price Lists
x-associatedSchema:
$ref: ./components/schemas/AdminPriceList.yaml
- name: Price Preferences
x-associatedSchema:
$ref: ./components/schemas/AdminPricePreference.yaml
- name: Product Categories
x-associatedSchema:
$ref: ./components/schemas/AdminProductCategory.yaml
- name: Product Tags
x-associatedSchema:
$ref: ./components/schemas/AdminProductTag.yaml
- name: Product Types
- name: Product Variants
x-associatedSchema:
$ref: ./components/schemas/AdminProductVariant.yaml
- name: Products
x-associatedSchema:
$ref: ./components/schemas/AdminProduct.yaml
- name: Promotions
x-associatedSchema:
$ref: ./components/schemas/AdminPromotion.yaml
- name: Refund Reasons
x-associatedSchema:
$ref: ./components/schemas/AdminRefundReason.yaml
- name: Regions
description: >
Regions are different countries or geographical regions that the commerce
store serves customers in.
Admins can manage these regions, their providers, and more.
externalDocs:
description: How to manage regions
url: >-
https://docs.medusajs.com/modules/regions-and-currencies/admin/manage-regions
x-associatedSchema:
$ref: ./components/schemas/AdminRegion.yaml
- name: Reservations
- name: Return Reasons
x-associatedSchema:
$ref: ./components/schemas/AdminReturnReason.yaml
- name: Returns
x-associatedSchema:
$ref: ./components/schemas/AdminReturn.yaml
- name: Sales Channels
description: >
A sales channel indicates a channel where products can be sold in. For
example, a webshop or a mobile app.
Admins can manage sales channels and the products available in them.
externalDocs:
description: How to manage sales channels
url: https://docs.medusajs.com/modules/sales-channels/admin/manage
x-associatedSchema:
$ref: ./components/schemas/AdminSalesChannel.yaml
- name: Shipping Options
x-associatedSchema:
$ref: ./components/schemas/AdminShippingOption.yaml
- name: Shipping Profiles
x-associatedSchema:
$ref: ./components/schemas/AdminShippingProfile.yaml
- name: Stock Locations
x-associatedSchema:
$ref: ./components/schemas/AdminStockLocation.yaml
- name: Stores
x-associatedSchema:
$ref: ./components/schemas/AdminStore.yaml
- name: Tax Rates
x-associatedSchema:
$ref: ./components/schemas/AdminTaxRate.yaml
- name: Tax Regions
x-associatedSchema:
$ref: ./components/schemas/AdminTaxRegion.yaml
- name: Uploads
- name: Users
x-associatedSchema:
$ref: ./components/schemas/AdminUser.yaml
- name: Workflows Executions
paths:
/admin/api-keys:
$ref: paths/admin_api-keys.yaml
/admin/api-keys/{id}:
$ref: paths/admin_api-keys_{id}.yaml
/admin/api-keys/{id}/revoke:
$ref: paths/admin_api-keys_{id}_revoke.yaml
/admin/api-keys/{id}/sales-channels:
$ref: paths/admin_api-keys_{id}_sales-channels.yaml
/admin/campaigns:
$ref: paths/admin_campaigns.yaml
/admin/campaigns/{id}:
$ref: paths/admin_campaigns_{id}.yaml
/admin/campaigns/{id}/promotions:
$ref: paths/admin_campaigns_{id}_promotions.yaml
/admin/claims:
$ref: paths/admin_claims.yaml
/admin/claims/{id}:
$ref: paths/admin_claims_{id}.yaml
/admin/claims/{id}/cancel:
$ref: paths/admin_claims_{id}_cancel.yaml
/admin/claims/{id}/claim-items:
$ref: paths/admin_claims_{id}_claim-items.yaml
/admin/claims/{id}/claim-items/{action_id}:
$ref: paths/admin_claims_{id}_claim-items_{action_id}.yaml
/admin/claims/{id}/inbound/items:
$ref: paths/admin_claims_{id}_inbound_items.yaml
/admin/claims/{id}/inbound/items/{action_id}:
$ref: paths/admin_claims_{id}_inbound_items_{action_id}.yaml
/admin/claims/{id}/inbound/shipping-method:
$ref: paths/admin_claims_{id}_inbound_shipping-method.yaml
/admin/claims/{id}/inbound/shipping-method/{action_id}:
$ref: paths/admin_claims_{id}_inbound_shipping-method_{action_id}.yaml
/admin/claims/{id}/outbound/items:
$ref: paths/admin_claims_{id}_outbound_items.yaml
/admin/claims/{id}/outbound/items/{action_id}:
$ref: paths/admin_claims_{id}_outbound_items_{action_id}.yaml
/admin/claims/{id}/outbound/shipping-method:
$ref: paths/admin_claims_{id}_outbound_shipping-method.yaml
/admin/claims/{id}/outbound/shipping-method/{action_id}:
$ref: paths/admin_claims_{id}_outbound_shipping-method_{action_id}.yaml
/admin/claims/{id}/request:
$ref: paths/admin_claims_{id}_request.yaml
/admin/collections:
$ref: paths/admin_collections.yaml
/admin/collections/{id}:
$ref: paths/admin_collections_{id}.yaml
/admin/collections/{id}/products:
$ref: paths/admin_collections_{id}_products.yaml
/admin/currencies:
$ref: paths/admin_currencies.yaml
/admin/currencies/{code}:
$ref: paths/admin_currencies_{code}.yaml
/admin/customer-groups:
$ref: paths/admin_customer-groups.yaml
/admin/customer-groups/{id}:
$ref: paths/admin_customer-groups_{id}.yaml
/admin/customer-groups/{id}/customers:
$ref: paths/admin_customer-groups_{id}_customers.yaml
/admin/customers:
$ref: paths/admin_customers.yaml
/admin/customers/{id}:
$ref: paths/admin_customers_{id}.yaml
/admin/customers/{id}/addresses:
$ref: paths/admin_customers_{id}_addresses.yaml
/admin/customers/{id}/addresses/{address_id}:
$ref: paths/admin_customers_{id}_addresses_{address_id}.yaml
/admin/draft-orders:
$ref: paths/admin_draft-orders.yaml
/admin/draft-orders/{id}:
$ref: paths/admin_draft-orders_{id}.yaml
/admin/exchanges:
$ref: paths/admin_exchanges.yaml
/admin/exchanges/{id}:
$ref: paths/admin_exchanges_{id}.yaml
/admin/exchanges/{id}/cancel:
$ref: paths/admin_exchanges_{id}_cancel.yaml
/admin/exchanges/{id}/inbound/items:
$ref: paths/admin_exchanges_{id}_inbound_items.yaml
/admin/exchanges/{id}/inbound/items/{action_id}:
$ref: paths/admin_exchanges_{id}_inbound_items_{action_id}.yaml
/admin/exchanges/{id}/inbound/shipping-method:
$ref: paths/admin_exchanges_{id}_inbound_shipping-method.yaml
/admin/exchanges/{id}/inbound/shipping-method/{action_id}:
$ref: paths/admin_exchanges_{id}_inbound_shipping-method_{action_id}.yaml
/admin/exchanges/{id}/outbound/items:
$ref: paths/admin_exchanges_{id}_outbound_items.yaml
/admin/exchanges/{id}/outbound/items/{action_id}:
$ref: paths/admin_exchanges_{id}_outbound_items_{action_id}.yaml
/admin/exchanges/{id}/outbound/shipping-method:
$ref: paths/admin_exchanges_{id}_outbound_shipping-method.yaml
/admin/exchanges/{id}/outbound/shipping-method/{action_id}:
$ref: paths/admin_exchanges_{id}_outbound_shipping-method_{action_id}.yaml
/admin/exchanges/{id}/request:
$ref: paths/admin_exchanges_{id}_request.yaml
/admin/fulfillment-providers:
$ref: paths/admin_fulfillment-providers.yaml
/admin/fulfillment-sets/{id}:
$ref: paths/admin_fulfillment-sets_{id}.yaml
/admin/fulfillment-sets/{id}/service-zones:
$ref: paths/admin_fulfillment-sets_{id}_service-zones.yaml
/admin/fulfillment-sets/{id}/service-zones/{zone_id}:
$ref: paths/admin_fulfillment-sets_{id}_service-zones_{zone_id}.yaml
/admin/fulfillments:
$ref: paths/admin_fulfillments.yaml
/admin/fulfillments/{id}/cancel:
$ref: paths/admin_fulfillments_{id}_cancel.yaml
/admin/fulfillments/{id}/shipment:
$ref: paths/admin_fulfillments_{id}_shipment.yaml
/admin/inventory-items:
$ref: paths/admin_inventory-items.yaml
/admin/inventory-items/{id}:
$ref: paths/admin_inventory-items_{id}.yaml
/admin/inventory-items/{id}/location-levels:
$ref: paths/admin_inventory-items_{id}_location-levels.yaml
/admin/inventory-items/{id}/location-levels/batch:
$ref: paths/admin_inventory-items_{id}_location-levels_batch.yaml
/admin/inventory-items/{id}/location-levels/{location_id}:
$ref: paths/admin_inventory-items_{id}_location-levels_{location_id}.yaml
/admin/invites:
$ref: paths/admin_invites.yaml
/admin/invites/accept:
$ref: paths/admin_invites_accept.yaml
/admin/invites/{id}:
$ref: paths/admin_invites_{id}.yaml
/admin/invites/{id}/resend:
$ref: paths/admin_invites_{id}_resend.yaml
/admin/notifications:
$ref: paths/admin_notifications.yaml
/admin/notifications/{id}:
$ref: paths/admin_notifications_{id}.yaml
/admin/order-edits:
$ref: paths/admin_order-edits.yaml
/admin/order-edits/{id}:
$ref: paths/admin_order-edits_{id}.yaml
/admin/order-edits/{id}/confirm:
$ref: paths/admin_order-edits_{id}_confirm.yaml
/admin/order-edits/{id}/items:
$ref: paths/admin_order-edits_{id}_items.yaml
/admin/order-edits/{id}/items/item/{item_id}:
$ref: paths/admin_order-edits_{id}_items_item_{item_id}.yaml
/admin/order-edits/{id}/items/{action_id}:
$ref: paths/admin_order-edits_{id}_items_{action_id}.yaml
/admin/order-edits/{id}/request:
$ref: paths/admin_order-edits_{id}_request.yaml
/admin/order-edits/{id}/shipping-method:
$ref: paths/admin_order-edits_{id}_shipping-method.yaml
/admin/order-edits/{id}/shipping-method/{action_id}:
$ref: paths/admin_order-edits_{id}_shipping-method_{action_id}.yaml
/admin/orders:
$ref: paths/admin_orders.yaml
/admin/orders/{id}:
$ref: paths/admin_orders_{id}.yaml
/admin/orders/{id}/archive:
$ref: paths/admin_orders_{id}_archive.yaml
/admin/orders/{id}/cancel:
$ref: paths/admin_orders_{id}_cancel.yaml
/admin/orders/{id}/complete:
$ref: paths/admin_orders_{id}_complete.yaml
/admin/orders/{id}/fulfillments:
$ref: paths/admin_orders_{id}_fulfillments.yaml
/admin/orders/{id}/fulfillments/{fulfillment_id}/cancel:
$ref: paths/admin_orders_{id}_fulfillments_{fulfillment_id}_cancel.yaml
/admin/orders/{id}/fulfillments/{fulfillment_id}/shipments:
$ref: paths/admin_orders_{id}_fulfillments_{fulfillment_id}_shipments.yaml
/admin/orders/{id}/preview:
$ref: paths/admin_orders_{id}_preview.yaml
/admin/payment-collections:
$ref: paths/admin_payment-collections.yaml
/admin/payment-collections/{id}:
$ref: paths/admin_payment-collections_{id}.yaml
/admin/payment-collections/{id}/mark-as-paid:
$ref: paths/admin_payment-collections_{id}_mark-as-paid.yaml
/admin/payments:
$ref: paths/admin_payments.yaml
/admin/payments/payment-providers:
$ref: paths/admin_payments_payment-providers.yaml
/admin/payments/{id}:
$ref: paths/admin_payments_{id}.yaml
/admin/payments/{id}/capture:
$ref: paths/admin_payments_{id}_capture.yaml
/admin/payments/{id}/refund:
$ref: paths/admin_payments_{id}_refund.yaml
/admin/price-lists:
$ref: paths/admin_price-lists.yaml
/admin/price-lists/{id}:
$ref: paths/admin_price-lists_{id}.yaml
/admin/price-lists/{id}/prices/batch:
$ref: paths/admin_price-lists_{id}_prices_batch.yaml
/admin/price-lists/{id}/products:
$ref: paths/admin_price-lists_{id}_products.yaml
/admin/price-preferences:
$ref: paths/admin_price-preferences.yaml
/admin/price-preferences/{id}:
$ref: paths/admin_price-preferences_{id}.yaml
/admin/product-categories:
$ref: paths/admin_product-categories.yaml
/admin/product-categories/{id}:
$ref: paths/admin_product-categories_{id}.yaml
/admin/product-categories/{id}/products:
$ref: paths/admin_product-categories_{id}_products.yaml
/admin/product-tags:
$ref: paths/admin_product-tags.yaml
/admin/product-tags/{id}:
$ref: paths/admin_product-tags_{id}.yaml
/admin/product-types:
$ref: paths/admin_product-types.yaml
/admin/product-types/{id}:
$ref: paths/admin_product-types_{id}.yaml
/admin/product-variants:
$ref: paths/admin_product-variants.yaml
/admin/products:
$ref: paths/admin_products.yaml
/admin/products/batch:
$ref: paths/admin_products_batch.yaml
/admin/products/export:
$ref: paths/admin_products_export.yaml
/admin/products/import:
$ref: paths/admin_products_import.yaml
/admin/products/import/{transaction_id}/confirm:
$ref: paths/admin_products_import_{transaction_id}_confirm.yaml
/admin/products/{id}:
$ref: paths/admin_products_{id}.yaml
/admin/products/{id}/options:
$ref: paths/admin_products_{id}_options.yaml
/admin/products/{id}/options/{option_id}:
$ref: paths/admin_products_{id}_options_{option_id}.yaml
/admin/products/{id}/variants:
$ref: paths/admin_products_{id}_variants.yaml
/admin/products/{id}/variants/batch:
$ref: paths/admin_products_{id}_variants_batch.yaml
/admin/products/{id}/variants/inventory-items/batch:
$ref: paths/admin_products_{id}_variants_inventory-items_batch.yaml
/admin/products/{id}/variants/{variant_id}:
$ref: paths/admin_products_{id}_variants_{variant_id}.yaml
/admin/products/{id}/variants/{variant_id}/inventory-items:
$ref: paths/admin_products_{id}_variants_{variant_id}_inventory-items.yaml
/admin/products/{id}/variants/{variant_id}/inventory-items/{inventory_item_id}:
$ref: >-
paths/admin_products_{id}_variants_{variant_id}_inventory-items_{inventory_item_id}.yaml
/admin/promotions:
$ref: paths/admin_promotions.yaml
/admin/promotions/rule-attribute-options/{rule_type}:
$ref: paths/admin_promotions_rule-attribute-options_{rule_type}.yaml
/admin/promotions/rule-value-options/{rule_type}/{rule_attribute_id}:
$ref: >-
paths/admin_promotions_rule-value-options_{rule_type}_{rule_attribute_id}.yaml
/admin/promotions/{id}:
$ref: paths/admin_promotions_{id}.yaml
/admin/promotions/{id}/buy-rules/batch:
$ref: paths/admin_promotions_{id}_buy-rules_batch.yaml
/admin/promotions/{id}/rules/batch:
$ref: paths/admin_promotions_{id}_rules_batch.yaml
/admin/promotions/{id}/target-rules/batch:
$ref: paths/admin_promotions_{id}_target-rules_batch.yaml
/admin/promotions/{id}/{rule_type}:
$ref: paths/admin_promotions_{id}_{rule_type}.yaml
/admin/refund-reasons:
$ref: paths/admin_refund-reasons.yaml
/admin/refund-reasons/{id}:
$ref: paths/admin_refund-reasons_{id}.yaml
/admin/regions:
$ref: paths/admin_regions.yaml
/admin/regions/{id}:
$ref: paths/admin_regions_{id}.yaml
/admin/reservations:
$ref: paths/admin_reservations.yaml
/admin/reservations/{id}:
$ref: paths/admin_reservations_{id}.yaml
/admin/return-reasons:
$ref: paths/admin_return-reasons.yaml
/admin/return-reasons/{id}:
$ref: paths/admin_return-reasons_{id}.yaml
/admin/returns:
$ref: paths/admin_returns.yaml
/admin/returns/{id}:
$ref: paths/admin_returns_{id}.yaml
/admin/returns/{id}/cancel:
$ref: paths/admin_returns_{id}_cancel.yaml
/admin/returns/{id}/dismiss-items:
$ref: paths/admin_returns_{id}_dismiss-items.yaml
/admin/returns/{id}/dismiss-items/{action_id}:
$ref: paths/admin_returns_{id}_dismiss-items_{action_id}.yaml
/admin/returns/{id}/receive:
$ref: paths/admin_returns_{id}_receive.yaml
/admin/returns/{id}/receive-items:
$ref: paths/admin_returns_{id}_receive-items.yaml
/admin/returns/{id}/receive-items/{action_id}:
$ref: paths/admin_returns_{id}_receive-items_{action_id}.yaml
/admin/returns/{id}/receive/confirm:
$ref: paths/admin_returns_{id}_receive_confirm.yaml
/admin/returns/{id}/request:
$ref: paths/admin_returns_{id}_request.yaml
/admin/returns/{id}/request-items:
$ref: paths/admin_returns_{id}_request-items.yaml
/admin/returns/{id}/request-items/{action_id}:
$ref: paths/admin_returns_{id}_request-items_{action_id}.yaml
/admin/returns/{id}/shipping-method:
$ref: paths/admin_returns_{id}_shipping-method.yaml
/admin/returns/{id}/shipping-method/{action_id}:
$ref: paths/admin_returns_{id}_shipping-method_{action_id}.yaml
/admin/sales-channels:
$ref: paths/admin_sales-channels.yaml
/admin/sales-channels/{id}:
$ref: paths/admin_sales-channels_{id}.yaml
/admin/sales-channels/{id}/products:
$ref: paths/admin_sales-channels_{id}_products.yaml
/admin/shipping-options:
$ref: paths/admin_shipping-options.yaml
/admin/shipping-options/{id}:
$ref: paths/admin_shipping-options_{id}.yaml
/admin/shipping-options/{id}/rules/batch:
$ref: paths/admin_shipping-options_{id}_rules_batch.yaml
/admin/shipping-profiles:
$ref: paths/admin_shipping-profiles.yaml
/admin/shipping-profiles/{id}:
$ref: paths/admin_shipping-profiles_{id}.yaml
/admin/stock-locations:
$ref: paths/admin_stock-locations.yaml
/admin/stock-locations/{id}:
$ref: paths/admin_stock-locations_{id}.yaml
/admin/stock-locations/{id}/fulfillment-providers:
$ref: paths/admin_stock-locations_{id}_fulfillment-providers.yaml
/admin/stock-locations/{id}/fulfillment-sets:
$ref: paths/admin_stock-locations_{id}_fulfillment-sets.yaml
/admin/stock-locations/{id}/sales-channels:
$ref: paths/admin_stock-locations_{id}_sales-channels.yaml
/admin/stores:
$ref: paths/admin_stores.yaml
/admin/stores/{id}:
$ref: paths/admin_stores_{id}.yaml
/admin/tax-rates:
$ref: paths/admin_tax-rates.yaml
/admin/tax-rates/{id}:
$ref: paths/admin_tax-rates_{id}.yaml
/admin/tax-rates/{id}/rules:
$ref: paths/admin_tax-rates_{id}_rules.yaml
/admin/tax-rates/{id}/rules/{rule_id}:
$ref: paths/admin_tax-rates_{id}_rules_{rule_id}.yaml
/admin/tax-regions:
$ref: paths/admin_tax-regions.yaml
/admin/tax-regions/{id}:
$ref: paths/admin_tax-regions_{id}.yaml
/admin/uploads:
$ref: paths/admin_uploads.yaml
/admin/uploads/{id}:
$ref: paths/admin_uploads_{id}.yaml
/admin/users:
$ref: paths/admin_users.yaml
/admin/users/me:
$ref: paths/admin_users_me.yaml
/admin/users/{id}:
$ref: paths/admin_users_{id}.yaml
/admin/workflows-executions:
$ref: paths/admin_workflows-executions.yaml
/admin/workflows-executions/{id}:
$ref: paths/admin_workflows-executions_{id}.yaml
/admin/workflows-executions/{workflow_id}/run:
$ref: paths/admin_workflows-executions_{workflow_id}_run.yaml
/admin/workflows-executions/{workflow_id}/steps/failure:
$ref: paths/admin_workflows-executions_{workflow_id}_steps_failure.yaml
/admin/workflows-executions/{workflow_id}/steps/success:
$ref: paths/admin_workflows-executions_{workflow_id}_steps_success.yaml
/admin/workflows-executions/{workflow_id}/subscribe:
$ref: paths/admin_workflows-executions_{workflow_id}_subscribe.yaml
/admin/workflows-executions/{workflow_id}/{transaction_id}:
$ref: paths/admin_workflows-executions_{workflow_id}_{transaction_id}.yaml
/admin/workflows-executions/{workflow_id}/{transaction_id}/{step_id}/subscribe:
$ref: >-
paths/admin_workflows-executions_{workflow_id}_{transaction_id}_{step_id}_subscribe.yaml
components:
securitySchemes:
api_token:
type: apiKey
x-displayName: API Token
in: header
name: x-medusa-access-token
jwt_token:
type: http
x-displayName: JWT Token
scheme: bearer
cookie_auth:
type: apiKey
in: cookie
name: connect.sid
x-displayName: Cookie Session ID