From 2f990a14e640669ae5bccfb4d4aa02b95a9b6e19 Mon Sep 17 00:00:00 2001 From: Shahed Nasser Date: Fri, 19 Sep 2025 11:40:52 +0300 Subject: [PATCH] docs: generate API reference for 2.10.3 (#13548) * docs: generate API reference for 2.10.3 * fix curl example --- .../Shell/admin_views_{entity}_columns/get.sh | 2 + .../get.sh | 2 + .../post.sh | 7 + .../get.sh | 2 + .../post.sh | 6 + .../delete.sh | 2 + .../get.sh | 2 + .../post.sh | 6 + .../admin/components/schemas/AdminColumn.yaml | 118 ++ .../schemas/AdminCreateViewConfiguration.yaml | 64 + ...tExchangesReturnRequestItemsReqSchema.yaml | 4 + .../AdminSetActiveViewConfiguration.yaml | 13 + .../schemas/AdminUpdateViewConfiguration.yaml | 59 + .../schemas/AdminViewConfiguration.yaml | 90 ++ .../AdminViewConfigurationResponse.yaml | 8 + .../AdminViewsEntityColumnsResponse.yaml | 11 + .../schemas/StoreAddCartLineItem.yaml | 21 - .../schemas/StoreAddCartShippingMethods.yaml | 19 - .../schemas/StoreUpdateCartLineItem.yaml | 16 - .../specs/admin/openapi.full.yaml | 1300 ++++++++++++++++- .../api-reference/specs/admin/openapi.yaml | 9 + .../paths/admin_views_{entity}_columns.yaml | 47 + .../admin_views_{entity}_configurations.yaml | 571 ++++++++ ..._views_{entity}_configurations_active.yaml | 154 ++ ...in_views_{entity}_configurations_{id}.yaml | 201 +++ .../store/components/schemas/AdminColumn.yaml | 118 ++ .../schemas/AdminCreateViewConfiguration.yaml | 64 + ...tExchangesReturnRequestItemsReqSchema.yaml | 4 + .../AdminSetActiveViewConfiguration.yaml | 13 + .../schemas/AdminUpdateViewConfiguration.yaml | 59 + .../schemas/AdminViewConfiguration.yaml | 90 ++ .../AdminViewConfigurationResponse.yaml | 8 + .../AdminViewsEntityColumnsResponse.yaml | 11 + .../schemas/StoreAddCartLineItem.yaml | 21 - .../schemas/StoreAddCartShippingMethods.yaml | 19 - .../schemas/StoreUpdateCartLineItem.yaml | 16 - .../specs/store/openapi.full.yaml | 500 ++++++- .../paths/store_carts_{id}_customer.yaml | 13 + .../paths/store_carts_{id}_line-items.yaml | 29 +- ...store_carts_{id}_line-items_{line_id}.yaml | 24 +- .../store_carts_{id}_shipping-methods.yaml | 32 +- www/utils/generated/events-output.json | 4 +- .../oas-output/base/admin.oas.base.yaml | 10 +- ...dmin_views_[entity]_configurations_[id].ts | 74 + .../admin/get_admin_views_[entity]_columns.ts | 50 + ...get_admin_views_[entity]_configurations.ts | 455 ++++++ ...dmin_views_[entity]_configurations_[id].ts | 67 + ...in_views_[entity]_configurations_active.ts | 75 + ...ost_admin_views_[entity]_configurations.ts | 61 + ...dmin_views_[entity]_configurations_[id].ts | 66 + ...in_views_[entity]_configurations_active.ts | 66 + .../store/post_store_carts_[id]_customer.ts | 12 +- .../store/post_store_carts_[id]_line-items.ts | 26 +- ...t_store_carts_[id]_line-items_[line_id].ts | 21 +- .../post_store_carts_[id]_shipping-methods.ts | 24 +- .../oas-output/schemas/AdminColumn.ts | 119 ++ .../schemas/AdminCreateViewConfiguration.ts | 67 + ...ostExchangesReturnRequestItemsReqSchema.ts | 4 + .../AdminSetActiveViewConfiguration.ts | 15 + .../schemas/AdminUpdateViewConfiguration.ts | 64 + .../schemas/AdminViewConfiguration.ts | 93 ++ .../schemas/AdminViewConfigurationResponse.ts | 13 + .../AdminViewsEntityColumnsResponse.ts | 16 + .../schemas/StoreAddCartLineItem.ts | 26 - .../schemas/StoreAddCartShippingMethods.ts | 21 - .../oas-output/schemas/StoreCartLineItem.ts | 33 +- .../schemas/StoreCartShippingMethod.ts | 24 +- .../schemas/StoreUpdateCartLineItem.ts | 21 - 68 files changed, 4955 insertions(+), 327 deletions(-) create mode 100644 www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_columns/get.sh create mode 100644 www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations/get.sh create mode 100644 www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations/post.sh create mode 100644 www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_active/get.sh create mode 100644 www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_active/post.sh create mode 100644 www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_{id}/delete.sh create mode 100644 www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_{id}/get.sh create mode 100644 www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_{id}/post.sh create mode 100644 www/apps/api-reference/specs/admin/components/schemas/AdminColumn.yaml create mode 100644 www/apps/api-reference/specs/admin/components/schemas/AdminCreateViewConfiguration.yaml create mode 100644 www/apps/api-reference/specs/admin/components/schemas/AdminSetActiveViewConfiguration.yaml create mode 100644 www/apps/api-reference/specs/admin/components/schemas/AdminUpdateViewConfiguration.yaml create mode 100644 www/apps/api-reference/specs/admin/components/schemas/AdminViewConfiguration.yaml create mode 100644 www/apps/api-reference/specs/admin/components/schemas/AdminViewConfigurationResponse.yaml create mode 100644 www/apps/api-reference/specs/admin/components/schemas/AdminViewsEntityColumnsResponse.yaml delete mode 100644 www/apps/api-reference/specs/admin/components/schemas/StoreAddCartLineItem.yaml delete mode 100644 www/apps/api-reference/specs/admin/components/schemas/StoreAddCartShippingMethods.yaml delete mode 100644 www/apps/api-reference/specs/admin/components/schemas/StoreUpdateCartLineItem.yaml create mode 100644 www/apps/api-reference/specs/admin/paths/admin_views_{entity}_columns.yaml create mode 100644 www/apps/api-reference/specs/admin/paths/admin_views_{entity}_configurations.yaml create mode 100644 www/apps/api-reference/specs/admin/paths/admin_views_{entity}_configurations_active.yaml create mode 100644 www/apps/api-reference/specs/admin/paths/admin_views_{entity}_configurations_{id}.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/AdminColumn.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/AdminCreateViewConfiguration.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/AdminSetActiveViewConfiguration.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/AdminUpdateViewConfiguration.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/AdminViewConfiguration.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/AdminViewConfigurationResponse.yaml create mode 100644 www/apps/api-reference/specs/store/components/schemas/AdminViewsEntityColumnsResponse.yaml delete mode 100644 www/apps/api-reference/specs/store/components/schemas/StoreAddCartLineItem.yaml delete mode 100644 www/apps/api-reference/specs/store/components/schemas/StoreAddCartShippingMethods.yaml delete mode 100644 www/apps/api-reference/specs/store/components/schemas/StoreUpdateCartLineItem.yaml create mode 100644 www/utils/generated/oas-output/operations/admin/delete_admin_views_[entity]_configurations_[id].ts create mode 100644 www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_columns.ts create mode 100644 www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_configurations.ts create mode 100644 www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_configurations_[id].ts create mode 100644 www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_configurations_active.ts create mode 100644 www/utils/generated/oas-output/operations/admin/post_admin_views_[entity]_configurations.ts create mode 100644 www/utils/generated/oas-output/operations/admin/post_admin_views_[entity]_configurations_[id].ts create mode 100644 www/utils/generated/oas-output/operations/admin/post_admin_views_[entity]_configurations_active.ts create mode 100644 www/utils/generated/oas-output/schemas/AdminColumn.ts create mode 100644 www/utils/generated/oas-output/schemas/AdminCreateViewConfiguration.ts create mode 100644 www/utils/generated/oas-output/schemas/AdminSetActiveViewConfiguration.ts create mode 100644 www/utils/generated/oas-output/schemas/AdminUpdateViewConfiguration.ts create mode 100644 www/utils/generated/oas-output/schemas/AdminViewConfiguration.ts create mode 100644 www/utils/generated/oas-output/schemas/AdminViewConfigurationResponse.ts create mode 100644 www/utils/generated/oas-output/schemas/AdminViewsEntityColumnsResponse.ts delete mode 100644 www/utils/generated/oas-output/schemas/StoreAddCartLineItem.ts delete mode 100644 www/utils/generated/oas-output/schemas/StoreAddCartShippingMethods.ts delete mode 100644 www/utils/generated/oas-output/schemas/StoreUpdateCartLineItem.ts diff --git a/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_columns/get.sh b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_columns/get.sh new file mode 100644 index 0000000000..4d94c5c104 --- /dev/null +++ b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_columns/get.sh @@ -0,0 +1,2 @@ +curl '{backend_url}/admin/views/{entity}/columns' \ +-H 'Authorization: Bearer {access_token}' \ No newline at end of file diff --git a/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations/get.sh b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations/get.sh new file mode 100644 index 0000000000..9d84684f68 --- /dev/null +++ b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations/get.sh @@ -0,0 +1,2 @@ +curl '{backend_url}/admin/views/{entity}/configurations' \ +-H 'Authorization: Bearer {access_token}' \ No newline at end of file diff --git a/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations/post.sh b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations/post.sh new file mode 100644 index 0000000000..0cdf06cfea --- /dev/null +++ b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations/post.sh @@ -0,0 +1,7 @@ +curl -X POST '{backend_url}/admin/views/{entity}/configurations' \ +-H 'Authorization: Bearer {access_token}' \ +-H 'Content-Type: application/json' \ +-d '{ + "is_system_default": true, + "name": "Custom View" +}' \ No newline at end of file diff --git a/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_active/get.sh b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_active/get.sh new file mode 100644 index 0000000000..de7f0a43ec --- /dev/null +++ b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_active/get.sh @@ -0,0 +1,2 @@ +curl '{backend_url}/admin/views/{entity}/configurations/active' \ +-H 'Authorization: Bearer {access_token}' \ No newline at end of file diff --git a/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_active/post.sh b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_active/post.sh new file mode 100644 index 0000000000..eb31e82682 --- /dev/null +++ b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_active/post.sh @@ -0,0 +1,6 @@ +curl -X POST '{backend_url}/admin/views/{entity}/configurations/active' \ +-H 'Authorization: Bearer {access_token}' \ +-H 'Content-Type: application/json' \ +--data-raw '{ + "view_configuration_id": "{value}" +}' \ No newline at end of file diff --git a/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_{id}/delete.sh b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_{id}/delete.sh new file mode 100644 index 0000000000..9149e899d4 --- /dev/null +++ b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_{id}/delete.sh @@ -0,0 +1,2 @@ +curl -X DELETE '{backend_url}/admin/views/{entity}/configurations/{id}' \ +-H 'Authorization: Bearer {access_token}' \ No newline at end of file diff --git a/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_{id}/get.sh b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_{id}/get.sh new file mode 100644 index 0000000000..ed8ee77564 --- /dev/null +++ b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_{id}/get.sh @@ -0,0 +1,2 @@ +curl '{backend_url}/admin/views/{entity}/configurations/{id}' \ +-H 'Authorization: Bearer {access_token}' \ No newline at end of file diff --git a/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_{id}/post.sh b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_{id}/post.sh new file mode 100644 index 0000000000..874dbd8d7e --- /dev/null +++ b/www/apps/api-reference/specs/admin/code_samples/Shell/admin_views_{entity}_configurations_{id}/post.sh @@ -0,0 +1,6 @@ +curl -X POST '{backend_url}/admin/views/{entity}/configurations/{id}' \ +-H 'Authorization: Bearer {access_token}' \ +-H 'Content-Type: application/json' \ +-d '{ + "is_system_default": true +}' \ No newline at end of file diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminColumn.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminColumn.yaml new file mode 100644 index 0000000000..4cc9108f45 --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminColumn.yaml @@ -0,0 +1,118 @@ +type: object +description: The details of a column in a view configuration. +x-schemaName: AdminColumn +required: + - id + - name + - field + - sortable + - hideable + - default_visible + - data_type +properties: + id: + type: string + title: id + description: The column's ID. + name: + type: string + title: name + description: The column's name. This is displayed in the view header. + description: + type: string + title: description + description: The column's description. + field: + type: string + title: field + description: The column's field in the entity. + sortable: + type: boolean + title: sortable + description: Whether the column is sortable. + hideable: + type: boolean + title: hideable + description: Whether the column is hideable. + default_visible: + type: boolean + title: default_visible + description: Whether the column is visible by default. + data_type: + type: string + description: The data type of the column's value. + enum: + - string + - number + - boolean + - object + - date + - currency + - enum + semantic_type: + type: string + title: semantic_type + description: >- + The column's semantic type. It can be `computed`, or other primitive + types. + context: + type: string + title: context + description: The column's context. It can be `display` or `generic`. + computed: + type: object + description: >- + A computed column's details. Only available if the column's + `semantic_type` is `computed`. + required: + - type + - required_fields + - optional_fields + properties: + type: + type: string + title: type + description: The computed's type for rendering. + required_fields: + type: array + description: The required fields in the computed column. + items: + type: string + title: required_fields + description: A required field in the computed column. + optional_fields: + type: array + description: The optional fields in the computed column. + items: + type: string + title: optional_fields + description: An optional field in the computed column. + relationship: + type: object + description: The relationship details. Only available for relationship columns. + required: + - entity + - field + properties: + entity: + type: string + title: entity + description: The related entity. + field: + type: string + title: field + description: The field in the related entity. + default_order: + type: number + title: default_order + description: The column's sort order in the default view configuration. + category: + type: string + description: The column's category. + enum: + - status + - metadata + - identifier + - timestamp + - metric + - relationship diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminCreateViewConfiguration.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateViewConfiguration.yaml new file mode 100644 index 0000000000..891034e6f1 --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminCreateViewConfiguration.yaml @@ -0,0 +1,64 @@ +type: object +description: The details of a view configuration to create. +x-schemaName: AdminCreateViewConfiguration +properties: + is_system_default: + type: boolean + title: is_system_default + description: >- + Whether the view is the system default. If so, it will be used as the + default view for all users that don't have a custom active view set. + set_active: + type: boolean + title: set_active + description: Whether the view is set as active. + configuration: + type: object + description: The view's configuration. + required: + - visible_columns + - column_order + properties: + visible_columns: + type: array + description: The configuration's visible columns. + items: + type: string + title: visible_columns + description: The visible column's name. + column_order: + type: array + description: The columns in the order they should be displayed. + items: + type: string + title: column_order + description: The column's name. + search: + type: string + title: search + description: The search query used in the view. + column_widths: + type: object + description: The column widths in the view. + filters: + type: object + description: The filters applied to the view. + sorting: + type: object + description: The sorting applied to the view. + required: + - id + - desc + properties: + id: + type: string + title: id + description: The ID of the sorting column. + desc: + type: boolean + title: desc + description: Whether the sorting is descending. + name: + type: string + title: name + description: The view's name. diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesReturnRequestItemsReqSchema.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesReturnRequestItemsReqSchema.yaml index 0149dfd44a..9056f17eb7 100644 --- a/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesReturnRequestItemsReqSchema.yaml +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminPostExchangesReturnRequestItemsReqSchema.yaml @@ -38,3 +38,7 @@ properties: externalDocs: url: https://docs.medusajs.com/api/admin#manage-metadata description: Learn how to manage metadata + location_id: + type: string + title: location_id + description: The ID of the location to which outbound items are sent from. diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminSetActiveViewConfiguration.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminSetActiveViewConfiguration.yaml new file mode 100644 index 0000000000..1749cb7ff9 --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminSetActiveViewConfiguration.yaml @@ -0,0 +1,13 @@ +type: object +description: The details of a view configuration to set as active for the given entity. +x-schemaName: AdminSetActiveViewConfiguration +required: + - view_configuration_id +properties: + view_configuration_id: + type: string + title: view_configuration_id + description: >- + The ID of the view configuration to set as active. If `null`, the active + view configuration will be cleared, and the `code` or system default view + configuration will be used as the active view. diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateViewConfiguration.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateViewConfiguration.yaml new file mode 100644 index 0000000000..03f05930b3 --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminUpdateViewConfiguration.yaml @@ -0,0 +1,59 @@ +type: object +description: The details to update in a view configuration. +x-schemaName: AdminUpdateViewConfiguration +properties: + set_active: + type: boolean + title: set_active + description: Whether the view is set as active. + name: + type: string + title: name + description: The view's name. + is_system_default: + type: boolean + title: is_system_default + description: Whether the view is the system default. + configuration: + type: object + description: The view's configuration. + properties: + search: + type: string + title: search + description: The search query used in the view. + visible_columns: + type: array + description: The configuration's visible columns. + items: + type: string + title: visible_columns + description: The visible column's name. + column_order: + type: array + description: The columns in the order they should be displayed. + items: + type: string + title: column_order + description: The column's name. + column_widths: + type: object + description: The column widths in the view. + filters: + type: object + description: The filters applied to the view. + sorting: + type: object + description: The sorting applied to the view. + required: + - id + - desc + properties: + id: + type: string + title: id + description: The ID of the sorting column. + desc: + type: boolean + title: desc + description: Whether the sorting is descending. diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminViewConfiguration.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminViewConfiguration.yaml new file mode 100644 index 0000000000..cc13b3372c --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminViewConfiguration.yaml @@ -0,0 +1,90 @@ +type: object +description: The details of a view configuration. +x-schemaName: AdminViewConfiguration +required: + - id + - entity + - name + - user_id + - is_system_default + - created_at + - updated_at +properties: + id: + type: string + title: id + description: The view configuration's ID. + entity: + type: string + title: entity + description: The entity the view configuration belongs to. + name: + type: string + title: name + description: The view configuration's name. + user_id: + type: string + title: user_id + description: >- + The ID of the user the view configuration belongs to. If `null`, the view + configuration is a system default. + is_system_default: + type: boolean + title: is_system_default + description: Whether the view configuration is the system default. + configuration: + type: object + description: The view's configuration. + required: + - visible_columns + - column_order + properties: + visible_columns: + type: array + description: The configuration's visible columns. + items: + type: string + title: visible_columns + description: The visible column's name. + column_order: + type: array + description: The columns in the order they should be displayed. + items: + type: string + title: column_order + description: The column's name. + column_widths: + type: object + description: The column widths in the view. + filters: + type: object + description: The filters applied to the view. + sorting: + type: object + description: The sorting applied to the view. + required: + - id + - desc + properties: + id: + type: string + title: id + description: The ID of the sorting column. + desc: + type: boolean + title: desc + description: Whether the sorting is descending. + search: + type: string + title: search + description: The configuration's search. + created_at: + type: string + format: date-time + title: created_at + description: The date the view configuration was created. + updated_at: + type: string + format: date-time + title: updated_at + description: The date the view configuration was updated. diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminViewConfigurationResponse.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminViewConfigurationResponse.yaml new file mode 100644 index 0000000000..52b739ad6a --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminViewConfigurationResponse.yaml @@ -0,0 +1,8 @@ +type: object +description: The details of a view configuration. +x-schemaName: AdminViewConfigurationResponse +required: + - view_configuration +properties: + view_configuration: + $ref: ./AdminViewConfiguration.yaml diff --git a/www/apps/api-reference/specs/admin/components/schemas/AdminViewsEntityColumnsResponse.yaml b/www/apps/api-reference/specs/admin/components/schemas/AdminViewsEntityColumnsResponse.yaml new file mode 100644 index 0000000000..8823b6120f --- /dev/null +++ b/www/apps/api-reference/specs/admin/components/schemas/AdminViewsEntityColumnsResponse.yaml @@ -0,0 +1,11 @@ +type: object +description: The view's columns. +x-schemaName: AdminViewsEntityColumnsResponse +required: + - columns +properties: + columns: + type: array + description: The view's columns. + items: + $ref: ./AdminColumn.yaml diff --git a/www/apps/api-reference/specs/admin/components/schemas/StoreAddCartLineItem.yaml b/www/apps/api-reference/specs/admin/components/schemas/StoreAddCartLineItem.yaml deleted file mode 100644 index b967a3087e..0000000000 --- a/www/apps/api-reference/specs/admin/components/schemas/StoreAddCartLineItem.yaml +++ /dev/null @@ -1,21 +0,0 @@ -type: object -description: The details of the line item to add. -x-schemaName: StoreAddCartLineItem -required: - - variant_id - - quantity -properties: - variant_id: - type: string - title: variant_id - description: The ID of the product variant to add to the cart. - quantity: - type: number - title: quantity - description: The item's quantity. - metadata: - type: object - description: The item's metadata, can hold custom key-value pairs. - externalDocs: - url: https://docs.medusajs.com/api/store#manage-metadata - description: Learn how to manage metadata diff --git a/www/apps/api-reference/specs/admin/components/schemas/StoreAddCartShippingMethods.yaml b/www/apps/api-reference/specs/admin/components/schemas/StoreAddCartShippingMethods.yaml deleted file mode 100644 index 494a059031..0000000000 --- a/www/apps/api-reference/specs/admin/components/schemas/StoreAddCartShippingMethods.yaml +++ /dev/null @@ -1,19 +0,0 @@ -type: object -description: The shipping method's details. -required: - - option_id -properties: - option_id: - type: string - title: option_id - description: The ID of the shipping option this method is created from. - data: - type: object - description: >- - Any additional data relevant for the third-party fulfillment provider to - process the shipment. - externalDocs: - url: >- - https://docs.medusajs.com/v2/resources/storefront-development/checkout/shipping#data-request-body-parameter - description: Learn more about the data parameter. -x-schemaName: StoreAddCartShippingMethods diff --git a/www/apps/api-reference/specs/admin/components/schemas/StoreUpdateCartLineItem.yaml b/www/apps/api-reference/specs/admin/components/schemas/StoreUpdateCartLineItem.yaml deleted file mode 100644 index dc31e201cc..0000000000 --- a/www/apps/api-reference/specs/admin/components/schemas/StoreUpdateCartLineItem.yaml +++ /dev/null @@ -1,16 +0,0 @@ -type: object -description: The details to update in the line item. -x-schemaName: StoreUpdateCartLineItem -required: - - quantity -properties: - quantity: - type: number - title: quantity - description: The item's quantity. - metadata: - type: object - description: The item's metadata, can hold custom key-value pairs. - externalDocs: - url: https://docs.medusajs.com/api/store#manage-metadata - description: Learn how to manage metadata diff --git a/www/apps/api-reference/specs/admin/openapi.full.yaml b/www/apps/api-reference/specs/admin/openapi.full.yaml index 87cc4245f5..b0e383be35 100644 --- a/www/apps/api-reference/specs/admin/openapi.full.yaml +++ b/www/apps/api-reference/specs/admin/openapi.full.yaml @@ -525,6 +525,7 @@ tags: url: https://docs.medusajs.com/resources/commerce-modules/user x-associatedSchema: $ref: '#/components/schemas/AdminUser' + - name: Views - name: Workflows Executions description: | These API routes allow you to track workflow executions in your Medusa application. @@ -54059,6 +54060,886 @@ paths: ``` description: Emitted when users are deleted. deprecated: false + /admin/views/{entity}/columns: + get: + operationId: GetViewsEntityColumns + summary: List Columns in View + x-sidebar-summary: List Columns + description: Retrieve a list of columns in a view for an entity. The columns are retrieved for the authenticated admin user. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to retrieve its columns (for example, `orders`) + required: true + schema: + type: string + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl '{backend_url}/admin/views/{entity}/columns' \ + -H 'Authorization: Bearer {access_token}' + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/AdminViewsEntityColumnsResponse' + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' + x-since: 2.10.3 + x-featureFlag: view_configurations + /admin/views/{entity}/configurations: + get: + operationId: GetViewsEntityConfigurations + summary: List View Configurations + description: Retrieve a list of view configurations of an entity. The configurations can be filtered by fields like `id`. The configurations can also be paginated. An admin user can only retrieve their own configurations. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to retrieve its view configurations (for example, `orders`) + required: true + schema: + type: string + - name: offset + in: query + description: The number of items to skip when retrieving a list. + required: false + schema: + type: number + title: offset + description: The number of items to skip when retrieving a list. + externalDocs: + url: '#pagination' + - name: limit + in: query + description: Limit the number of items returned in the list. + required: false + schema: + type: number + title: limit + description: Limit the number of items returned in the list. + externalDocs: + url: '#pagination' + - name: order + in: query + description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + required: false + schema: + type: string + title: order + description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + externalDocs: + url: '#pagination' + - name: with_deleted + in: query + description: Whether to include deleted records in the result. + required: false + schema: + type: boolean + title: with_deleted + description: Whether to include deleted records in the result. + - name: id + in: query + required: false + schema: + oneOf: + - type: string + title: id + description: Filter by a view configuration ID. + - type: array + description: Filter by view configuration IDs. + items: + type: string + title: id + description: The view configuration ID. + - name: entity + in: query + required: false + schema: + oneOf: + - type: string + title: entity + description: Filter by an entity. + - type: array + description: Filter by entities. + items: + type: string + title: entity + description: An entity. + - name: name + in: query + required: false + schema: + oneOf: + - type: string + title: name + description: Filter by a view's name. + - type: array + description: Filter by view names. + items: + type: string + title: name + description: The view's name. + - name: user_id + in: query + required: false + schema: + oneOf: + - type: string + title: user_id + description: Filter by the ID of the user who owns the view. + - type: array + description: Filter by the IDs of users who own the view. + items: + type: string + title: user_id + description: The user ID. + - name: is_system_default + in: query + description: Filter by whether the view is a system default. + required: false + schema: + type: boolean + title: is_system_default + description: Whether the view is a system default. + - name: created_at + in: query + description: Filter by a view configuration's creation date. + required: false + schema: + type: object + description: Filter by a view configuration's creation date. + properties: + $and: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by an exact match. + items: + type: string + title: $eq + description: Filter by an exact match. + $ne: + type: string + title: $ne + description: Filter by values not equal to this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: Filter by values in this array. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: Filter by values not in this array. + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching the conditions in this parameter. + - type: object + description: Filter by values not matching the conditions in this parameter. + - type: array + description: Filter by values not matching the conditions in this parameter. + items: + type: string + title: $not + description: Filter by values not matching the conditions in this parameter. + $gt: + type: string + title: $gt + description: Filter by values greater than this parameter. Useful for numbers and dates only. + $gte: + type: string + title: $gte + description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: Filter by values less than this parameter. Useful for numbers and dates only. + $lte: + type: string + title: $lte + description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: Filter arrays that have overlapping values with this parameter. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: Filter arrays that contain some of the values of this parameter. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: Filter arrays that contain all values of this parameter. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). + - name: updated_at + in: query + description: Filter by a view configuration's update date. + required: false + schema: + type: object + description: Filter by a view configuration's update date. + properties: + $and: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by an exact match. + items: + type: string + title: $eq + description: Filter by an exact match. + $ne: + type: string + title: $ne + description: Filter by values not equal to this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: Filter by values in this array. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: Filter by values not in this array. + $not: + oneOf: + - type: string + title: $not + description: Filter by values not matching the conditions in this parameter. + - type: object + description: Filter by values not matching the conditions in this parameter. + - type: array + description: Filter by values not matching the conditions in this parameter. + items: + type: string + title: $not + description: Filter by values not matching the conditions in this parameter. + $gt: + type: string + title: $gt + description: Filter by values greater than this parameter. Useful for numbers and dates only. + $gte: + type: string + title: $gte + description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + $lt: + type: string + title: $lt + description: Filter by values less than this parameter. Useful for numbers and dates only. + $lte: + type: string + title: $lte + description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: Filter arrays that have overlapping values with this parameter. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: Filter arrays that contain some of the values of this parameter. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: Filter arrays that contain all values of this parameter. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). + - name: fields + in: query + description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. + required: false + schema: + type: string + title: fields + description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + - name: $and + in: query + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + required: false + schema: + type: array + description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $and + - name: $or + in: query + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + required: false + schema: + type: array + description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + items: + type: object + title: $or + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl '{backend_url}/admin/views/{entity}/configurations' \ + -H 'Authorization: Bearer {access_token}' + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + allOf: + - type: object + description: The list of view configurations. + required: + - limit + - offset + - count + properties: + limit: + type: number + title: limit + description: The maximum number of returned items. + offset: + type: number + title: offset + description: The number of items skipped before retrieving the returned items. + count: + type: number + title: count + description: The total number of items. + estimate_count: + type: number + title: estimate_count + description: The estimated count retrieved from the PostgreSQL query planner, which may be inaccurate. + x-featureFlag: index_engine + - type: object + description: The list of view configurations. + required: + - view_configurations + properties: + view_configurations: + type: array + description: The list of view configurations. + items: + $ref: '#/components/schemas/AdminViewConfiguration' + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' + x-since: 2.10.3 + x-featureFlag: view_configurations + post: + operationId: PostViewsEntityConfigurations + summary: Create View Configuration + description: Create a new view configuration for an entity. If `is_system_default` is set to true, the created configuration will be set as the system default for the specified entity. Otherwise, it will be a custom configuration for the admin user. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to create its view configuration (for example, `orders`). + required: true + schema: + type: string + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AdminCreateViewConfiguration' + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl -X POST '{backend_url}/admin/views/{entity}/configurations' \ + -H 'Authorization: Bearer {access_token}' \ + -H 'Content-Type: application/json' \ + -d '{ + "is_system_default": true, + "name": "Custom View" + }' + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/AdminViewConfigurationResponse' + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' + x-workflow: createViewConfigurationWorkflow + x-events: [] + x-since: 2.10.3 + x-featureFlag: view_configurations + /admin/views/{entity}/configurations/active: + get: + operationId: GetViewsEntityConfigurationsActive + summary: Get Active View Configuration + description: Get the active view configurations for an entity. If no active view is set, `null` is returned. An admin user can only retrieve their own active configuration. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to retrieve its active view configurations (for example, `orders`). + required: true + schema: + type: string + - name: fields + in: query + description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. + required: false + schema: + type: string + title: fields + description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl '{backend_url}/admin/views/{entity}/configurations/active' \ + -H 'Authorization: Bearer {access_token}' + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + allOf: + - $ref: '#/components/schemas/AdminViewConfigurationResponse' + - type: object + description: Additional properties related to the active view configuration. + properties: + is_default_active: + type: boolean + title: is_default_active + description: Whether the active view configuration is the system default. + default_type: + type: string + description: The type of the default view configuration if the active view is the system default. It will be `system` if the active view is the system default, `code` if no active view is set, or `undefined` if the active view isn't the system default. + enum: + - code + - system + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' + x-since: 2.10.3 + x-featureFlag: view_configurations + post: + operationId: PostViewsEntityConfigurationsActive + summary: Make View Configuration Active + description: Make a view configuration active. This will set the given view configuration as the active one for the specified entity for the admin user. An admin user can only set their own configurations as active. If the view configuration ID is `null`, the active view configuration will be cleared, and the `code` or system default view configuration type will be used as the active view. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to update its view configuration (for example, `orders`). + required: true + schema: + type: string + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AdminSetActiveViewConfiguration' + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl -X POST '{backend_url}/admin/views/{entity}/configurations/active' \ + -H 'Authorization: Bearer {access_token}' \ + -H 'Content-Type: application/json' \ + --data-raw '{ + "view_configuration_id": "{value}" + }' + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + description: The details of the operation. + required: + - success + properties: + success: + type: boolean + title: success + description: Whether the operation was successful. + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' + x-since: 2.10.3 + x-featureFlag: view_configurations + /admin/views/{entity}/configurations/{id}: + get: + operationId: GetViewsEntityConfigurationsId + summary: Get View Configuration + description: Retrieve a view configuration for an entity. An admin user can only retrieve their own configurations. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to retrieve its view configurations (for example, `orders`) + required: true + schema: + type: string + - name: id + in: path + description: The ID of the view configuration to retrieve. + required: true + schema: + type: string + - name: fields + in: query + description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. + required: false + schema: + type: string + title: fields + description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl '{backend_url}/admin/views/{entity}/configurations/{id}' \ + -H 'Authorization: Bearer {access_token}' + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/AdminViewConfigurationResponse' + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' + x-since: 2.10.3 + x-featureFlag: view_configurations + post: + operationId: PostViewsEntityConfigurationsId + summary: Update View Configuration + description: Update the view configuration of an entity. An admin user can only update their own configurations. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to update its view configuration (for example, `orders`). + required: true + schema: + type: string + - name: id + in: path + description: The view configuration's ID. + required: true + schema: + type: string + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AdminUpdateViewConfiguration' + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl -X POST '{backend_url}/admin/views/{entity}/configurations/{id}' \ + -H 'Authorization: Bearer {access_token}' \ + -H 'Content-Type: application/json' \ + -d '{ + "is_system_default": true + }' + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/AdminViewConfigurationResponse' + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' + x-workflow: updateViewConfigurationWorkflow + x-events: [] + x-since: 2.10.3 + x-featureFlag: view_configurations + delete: + operationId: DeleteViewsEntityConfigurationsId + summary: Remove View Configurations + description: Remove view configurations of an entity. An admin user can only delete their own configurations. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to delete its view configuration (for example, `orders`) + required: true + schema: + type: string + - name: id + in: path + description: The ID of the view configuration to delete + required: true + schema: + type: string + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + x-codeSamples: + - lang: Shell + label: cURL + source: |- + curl -X DELETE '{backend_url}/admin/views/{entity}/configurations/{id}' \ + -H 'Authorization: Bearer {access_token}' + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + description: The details of the deletion operation. + required: + - id + - object + - deleted + properties: + id: + type: string + title: id + description: The ID of the deleted View Configuration. + object: + type: string + title: object + description: The name of the deleted object. + example: view_configuration + deleted: + type: boolean + title: deleted + description: Whether the view was deleted. + '400': + $ref: '#/components/responses/400_error' + '401': + $ref: '#/components/responses/unauthorized' + '404': + $ref: '#/components/responses/not_found_error' + '409': + $ref: '#/components/responses/invalid_state_error' + '422': + $ref: '#/components/responses/invalid_request_error' + '500': + $ref: '#/components/responses/500_error' + x-since: 2.10.3 + x-featureFlag: view_configurations /admin/workflows-executions: get: operationId: GetWorkflowsExecutions @@ -56525,6 +57406,121 @@ components: properties: collection: $ref: '#/components/schemas/AdminCollection' + AdminColumn: + type: object + description: The details of a column in a view configuration. + x-schemaName: AdminColumn + required: + - id + - name + - field + - sortable + - hideable + - default_visible + - data_type + properties: + id: + type: string + title: id + description: The column's ID. + name: + type: string + title: name + description: The column's name. This is displayed in the view header. + description: + type: string + title: description + description: The column's description. + field: + type: string + title: field + description: The column's field in the entity. + sortable: + type: boolean + title: sortable + description: Whether the column is sortable. + hideable: + type: boolean + title: hideable + description: Whether the column is hideable. + default_visible: + type: boolean + title: default_visible + description: Whether the column is visible by default. + data_type: + type: string + description: The data type of the column's value. + enum: + - string + - number + - boolean + - object + - date + - currency + - enum + semantic_type: + type: string + title: semantic_type + description: The column's semantic type. It can be `computed`, or other primitive types. + context: + type: string + title: context + description: The column's context. It can be `display` or `generic`. + computed: + type: object + description: A computed column's details. Only available if the column's `semantic_type` is `computed`. + required: + - type + - required_fields + - optional_fields + properties: + type: + type: string + title: type + description: The computed's type for rendering. + required_fields: + type: array + description: The required fields in the computed column. + items: + type: string + title: required_fields + description: A required field in the computed column. + optional_fields: + type: array + description: The optional fields in the computed column. + items: + type: string + title: optional_fields + description: An optional field in the computed column. + relationship: + type: object + description: The relationship details. Only available for relationship columns. + required: + - entity + - field + properties: + entity: + type: string + title: entity + description: The related entity. + field: + type: string + title: field + description: The field in the related entity. + default_order: + type: number + title: default_order + description: The column's sort order in the default view configuration. + category: + type: string + description: The column's category. + enum: + - status + - metadata + - identifier + - timestamp + - metric + - relationship AdminCreateApiKey: type: object description: The API key's details. @@ -58186,6 +59182,69 @@ components: type: string title: inventory_item_id description: The inventory item's ID. + AdminCreateViewConfiguration: + type: object + description: The details of a view configuration to create. + x-schemaName: AdminCreateViewConfiguration + properties: + is_system_default: + type: boolean + title: is_system_default + description: Whether the view is the system default. If so, it will be used as the default view for all users that don't have a custom active view set. + set_active: + type: boolean + title: set_active + description: Whether the view is set as active. + configuration: + type: object + description: The view's configuration. + required: + - visible_columns + - column_order + properties: + visible_columns: + type: array + description: The configuration's visible columns. + items: + type: string + title: visible_columns + description: The visible column's name. + column_order: + type: array + description: The columns in the order they should be displayed. + items: + type: string + title: column_order + description: The column's name. + search: + type: string + title: search + description: The search query used in the view. + column_widths: + type: object + description: The column widths in the view. + filters: + type: object + description: The filters applied to the view. + sorting: + type: object + description: The sorting applied to the view. + required: + - id + - desc + properties: + id: + type: string + title: id + description: The ID of the sorting column. + desc: + type: boolean + title: desc + description: Whether the sorting is descending. + name: + type: string + title: name + description: The view's name. AdminCreateWorkflowsAsyncResponse: type: object description: The details of changing a workflow execution's step status. @@ -63793,6 +64852,10 @@ components: externalDocs: url: https://docs.medusajs.com/api/admin#manage-metadata description: Learn how to manage metadata + location_id: + type: string + title: location_id + description: The ID of the location to which outbound items are sent from. AdminPostExchangesShippingActionReqSchema: type: object description: The details of the shipping method to update. @@ -66695,6 +67758,17 @@ components: properties: service_zone: $ref: '#/components/schemas/AdminServiceZone' + AdminSetActiveViewConfiguration: + type: object + description: The details of a view configuration to set as active for the given entity. + x-schemaName: AdminSetActiveViewConfiguration + required: + - view_configuration_id + properties: + view_configuration_id: + type: string + title: view_configuration_id + description: The ID of the view configuration to set as active. If `null`, the active view configuration will be cleared, and the `code` or system default view configuration will be used as the active view. AdminShippingOption: type: object description: The shipping option's details. @@ -69559,6 +70633,66 @@ components: type: number title: required_quantity description: The number of units a single quantity is equivalent to. For example, if a customer orders one quantity of the variant, Medusa checks the availability of the quantity multiplied by the value set for `required_quantity`. When the customer orders the quantity, Medusa reserves the ordered quantity multiplied by the value set for `required_quantity`. + AdminUpdateViewConfiguration: + type: object + description: The details to update in a view configuration. + x-schemaName: AdminUpdateViewConfiguration + properties: + set_active: + type: boolean + title: set_active + description: Whether the view is set as active. + name: + type: string + title: name + description: The view's name. + is_system_default: + type: boolean + title: is_system_default + description: Whether the view is the system default. + configuration: + type: object + description: The view's configuration. + properties: + search: + type: string + title: search + description: The search query used in the view. + visible_columns: + type: array + description: The configuration's visible columns. + items: + type: string + title: visible_columns + description: The visible column's name. + column_order: + type: array + description: The columns in the order they should be displayed. + items: + type: string + title: column_order + description: The column's name. + column_widths: + type: object + description: The column widths in the view. + filters: + type: object + description: The filters applied to the view. + sorting: + type: object + description: The sorting applied to the view. + required: + - id + - desc + properties: + id: + type: string + title: id + description: The ID of the sorting column. + desc: + type: boolean + title: desc + description: Whether the sorting is descending. AdminUploadPreSignedUrl: type: object description: The details of the file to upload. @@ -69790,6 +70924,116 @@ components: properties: user: $ref: '#/components/schemas/AdminUser' + AdminViewConfiguration: + type: object + description: The details of a view configuration. + x-schemaName: AdminViewConfiguration + required: + - id + - entity + - name + - user_id + - is_system_default + - created_at + - updated_at + properties: + id: + type: string + title: id + description: The view configuration's ID. + entity: + type: string + title: entity + description: The entity the view configuration belongs to. + name: + type: string + title: name + description: The view configuration's name. + user_id: + type: string + title: user_id + description: The ID of the user the view configuration belongs to. If `null`, the view configuration is a system default. + is_system_default: + type: boolean + title: is_system_default + description: Whether the view configuration is the system default. + configuration: + type: object + description: The view's configuration. + required: + - visible_columns + - column_order + properties: + visible_columns: + type: array + description: The configuration's visible columns. + items: + type: string + title: visible_columns + description: The visible column's name. + column_order: + type: array + description: The columns in the order they should be displayed. + items: + type: string + title: column_order + description: The column's name. + column_widths: + type: object + description: The column widths in the view. + filters: + type: object + description: The filters applied to the view. + sorting: + type: object + description: The sorting applied to the view. + required: + - id + - desc + properties: + id: + type: string + title: id + description: The ID of the sorting column. + desc: + type: boolean + title: desc + description: Whether the sorting is descending. + search: + type: string + title: search + description: The configuration's search. + created_at: + type: string + format: date-time + title: created_at + description: The date the view configuration was created. + updated_at: + type: string + format: date-time + title: updated_at + description: The date the view configuration was updated. + AdminViewConfigurationResponse: + type: object + description: The details of a view configuration. + x-schemaName: AdminViewConfigurationResponse + required: + - view_configuration + properties: + view_configuration: + $ref: '#/components/schemas/AdminViewConfiguration' + AdminViewsEntityColumnsResponse: + type: object + description: The view's columns. + x-schemaName: AdminViewsEntityColumnsResponse + required: + - columns + properties: + columns: + type: array + description: The view's columns. + items: + $ref: '#/components/schemas/AdminColumn' AdminWorkflowExecution: type: object description: The workflows execution's details. @@ -75789,45 +77033,6 @@ components: type: string title: token description: The order transfer's token issued when the transfer was requested. - StoreAddCartLineItem: - type: object - description: The details of the line item to add. - x-schemaName: StoreAddCartLineItem - required: - - variant_id - - quantity - properties: - variant_id: - type: string - title: variant_id - description: The ID of the product variant to add to the cart. - quantity: - type: number - title: quantity - description: The item's quantity. - metadata: - type: object - description: The item's metadata, can hold custom key-value pairs. - externalDocs: - url: https://docs.medusajs.com/api/store#manage-metadata - description: Learn how to manage metadata - StoreAddCartShippingMethods: - type: object - description: The shipping method's details. - required: - - option_id - properties: - option_id: - type: string - title: option_id - description: The ID of the shipping option this method is created from. - data: - type: object - description: Any additional data relevant for the third-party fulfillment provider to process the shipment. - externalDocs: - url: https://docs.medusajs.com/v2/resources/storefront-development/checkout/shipping#data-request-body-parameter - description: Learn more about the data parameter. - x-schemaName: StoreAddCartShippingMethods StoreAddGiftCardToCart: type: object description: The details to add a gift card to the cart. @@ -85466,23 +86671,6 @@ components: url: https://docs.medusajs.com/api/store#manage-metadata description: Learn how to manage metadata x-schemaName: StoreTransactionGroup - StoreUpdateCartLineItem: - type: object - description: The details to update in the line item. - x-schemaName: StoreUpdateCartLineItem - required: - - quantity - properties: - quantity: - type: number - title: quantity - description: The item's quantity. - metadata: - type: object - description: The item's metadata, can hold custom key-value pairs. - externalDocs: - url: https://docs.medusajs.com/api/store#manage-metadata - description: Learn how to manage metadata StoreUpdateCustomer: type: object description: The details to update in the customer. diff --git a/www/apps/api-reference/specs/admin/openapi.yaml b/www/apps/api-reference/specs/admin/openapi.yaml index 1da14eed04..0425eb038f 100644 --- a/www/apps/api-reference/specs/admin/openapi.yaml +++ b/www/apps/api-reference/specs/admin/openapi.yaml @@ -715,6 +715,7 @@ tags: url: https://docs.medusajs.com/resources/commerce-modules/user x-associatedSchema: $ref: ./components/schemas/AdminUser.yaml + - name: Views - name: Workflows Executions description: > These API routes allow you to track workflow executions in your Medusa @@ -1156,6 +1157,14 @@ paths: $ref: paths/admin_users_me.yaml /admin/users/{id}: $ref: paths/admin_users_{id}.yaml + /admin/views/{entity}/columns: + $ref: paths/admin_views_{entity}_columns.yaml + /admin/views/{entity}/configurations: + $ref: paths/admin_views_{entity}_configurations.yaml + /admin/views/{entity}/configurations/active: + $ref: paths/admin_views_{entity}_configurations_active.yaml + /admin/views/{entity}/configurations/{id}: + $ref: paths/admin_views_{entity}_configurations_{id}.yaml /admin/workflows-executions: $ref: paths/admin_workflows-executions.yaml /admin/workflows-executions/{id}: diff --git a/www/apps/api-reference/specs/admin/paths/admin_views_{entity}_columns.yaml b/www/apps/api-reference/specs/admin/paths/admin_views_{entity}_columns.yaml new file mode 100644 index 0000000000..190a820982 --- /dev/null +++ b/www/apps/api-reference/specs/admin/paths/admin_views_{entity}_columns.yaml @@ -0,0 +1,47 @@ +get: + operationId: GetViewsEntityColumns + summary: List Columns in View + x-sidebar-summary: List Columns + description: >- + Retrieve a list of columns in a view for an entity. The columns are + retrieved for the authenticated admin user. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to retrieve its columns (for example, `orders`) + required: true + schema: + type: string + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + x-codeSamples: + - lang: Shell + label: cURL + source: + $ref: ../code_samples/Shell/admin_views_{entity}_columns/get.sh + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: ../components/schemas/AdminViewsEntityColumnsResponse.yaml + '400': + $ref: ../components/responses/400_error.yaml + '401': + $ref: ../components/responses/unauthorized.yaml + '404': + $ref: ../components/responses/not_found_error.yaml + '409': + $ref: ../components/responses/invalid_state_error.yaml + '422': + $ref: ../components/responses/invalid_request_error.yaml + '500': + $ref: ../components/responses/500_error.yaml + x-since: 2.10.3 + x-featureFlag: view_configurations diff --git a/www/apps/api-reference/specs/admin/paths/admin_views_{entity}_configurations.yaml b/www/apps/api-reference/specs/admin/paths/admin_views_{entity}_configurations.yaml new file mode 100644 index 0000000000..a06da1fcf7 --- /dev/null +++ b/www/apps/api-reference/specs/admin/paths/admin_views_{entity}_configurations.yaml @@ -0,0 +1,571 @@ +get: + operationId: GetViewsEntityConfigurations + summary: List View Configurations + description: >- + Retrieve a list of view configurations of an entity. The configurations can + be filtered by fields like `id`. The configurations can also be paginated. + An admin user can only retrieve their own configurations. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to retrieve its view configurations (for example, `orders`) + required: true + schema: + type: string + - name: offset + in: query + description: The number of items to skip when retrieving a list. + required: false + schema: + type: number + title: offset + description: The number of items to skip when retrieving a list. + externalDocs: + url: '#pagination' + - name: limit + in: query + description: Limit the number of items returned in the list. + required: false + schema: + type: number + title: limit + description: Limit the number of items returned in the list. + externalDocs: + url: '#pagination' + - name: order + in: query + description: >- + The field to sort the data by. By default, the sort order is ascending. + To change the order to descending, prefix the field name with `-`. + required: false + schema: + type: string + title: order + description: >- + The field to sort the data by. By default, the sort order is + ascending. To change the order to descending, prefix the field name + with `-`. + externalDocs: + url: '#pagination' + - name: with_deleted + in: query + description: Whether to include deleted records in the result. + required: false + schema: + type: boolean + title: with_deleted + description: Whether to include deleted records in the result. + - name: id + in: query + required: false + schema: + oneOf: + - type: string + title: id + description: Filter by a view configuration ID. + - type: array + description: Filter by view configuration IDs. + items: + type: string + title: id + description: The view configuration ID. + - name: entity + in: query + required: false + schema: + oneOf: + - type: string + title: entity + description: Filter by an entity. + - type: array + description: Filter by entities. + items: + type: string + title: entity + description: An entity. + - name: name + in: query + required: false + schema: + oneOf: + - type: string + title: name + description: Filter by a view's name. + - type: array + description: Filter by view names. + items: + type: string + title: name + description: The view's name. + - name: user_id + in: query + required: false + schema: + oneOf: + - type: string + title: user_id + description: Filter by the ID of the user who owns the view. + - type: array + description: Filter by the IDs of users who own the view. + items: + type: string + title: user_id + description: The user ID. + - name: is_system_default + in: query + description: Filter by whether the view is a system default. + required: false + schema: + type: boolean + title: is_system_default + description: Whether the view is a system default. + - name: created_at + in: query + description: Filter by a view configuration's creation date. + required: false + schema: + type: object + description: Filter by a view configuration's creation date. + properties: + $and: + type: array + description: >- + Join query parameters with an AND condition. Each object's content + is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: >- + Join query parameters with an OR condition. Each object's content + is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by an exact match. + items: + type: string + title: $eq + description: Filter by an exact match. + $ne: + type: string + title: $ne + description: Filter by values not equal to this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: Filter by values in this array. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: Filter by values not in this array. + $not: + oneOf: + - type: string + title: $not + description: >- + Filter by values not matching the conditions in this + parameter. + - type: object + description: >- + Filter by values not matching the conditions in this + parameter. + - type: array + description: >- + Filter by values not matching the conditions in this + parameter. + items: + type: string + title: $not + description: >- + Filter by values not matching the conditions in this + parameter. + $gt: + type: string + title: $gt + description: >- + Filter by values greater than this parameter. Useful for numbers + and dates only. + $gte: + type: string + title: $gte + description: >- + Filter by values greater than or equal to this parameter. Useful + for numbers and dates only. + $lt: + type: string + title: $lt + description: >- + Filter by values less than this parameter. Useful for numbers and + dates only. + $lte: + type: string + title: $lte + description: >- + Filter by values less than or equal to this parameter. Useful for + numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: Filter arrays that have overlapping values with this parameter. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: Filter arrays that contain some of the values of this parameter. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: Filter arrays that contain all values of this parameter. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). + - name: updated_at + in: query + description: Filter by a view configuration's update date. + required: false + schema: + type: object + description: Filter by a view configuration's update date. + properties: + $and: + type: array + description: >- + Join query parameters with an AND condition. Each object's content + is the same type as the expected query parameters. + items: + type: object + title: $and + $or: + type: array + description: >- + Join query parameters with an OR condition. Each object's content + is the same type as the expected query parameters. + items: + type: object + title: $or + $eq: + oneOf: + - type: string + title: $eq + description: Filter by an exact match. + - type: array + description: Filter by an exact match. + items: + type: string + title: $eq + description: Filter by an exact match. + $ne: + type: string + title: $ne + description: Filter by values not equal to this parameter. + $in: + type: array + description: Filter by values in this array. + items: + type: string + title: $in + description: Filter by values in this array. + $nin: + type: array + description: Filter by values not in this array. + items: + type: string + title: $nin + description: Filter by values not in this array. + $not: + oneOf: + - type: string + title: $not + description: >- + Filter by values not matching the conditions in this + parameter. + - type: object + description: >- + Filter by values not matching the conditions in this + parameter. + - type: array + description: >- + Filter by values not matching the conditions in this + parameter. + items: + type: string + title: $not + description: >- + Filter by values not matching the conditions in this + parameter. + $gt: + type: string + title: $gt + description: >- + Filter by values greater than this parameter. Useful for numbers + and dates only. + $gte: + type: string + title: $gte + description: >- + Filter by values greater than or equal to this parameter. Useful + for numbers and dates only. + $lt: + type: string + title: $lt + description: >- + Filter by values less than this parameter. Useful for numbers and + dates only. + $lte: + type: string + title: $lte + description: >- + Filter by values less than or equal to this parameter. Useful for + numbers and dates only. + $like: + type: string + title: $like + description: Apply a `like` filter. Useful for strings only. + $re: + type: string + title: $re + description: Apply a regex filter. Useful for strings only. + $ilike: + type: string + title: $ilike + description: Apply a case-insensitive `like` filter. Useful for strings only. + $fulltext: + type: string + title: $fulltext + description: Filter to apply on full-text properties. + $overlap: + type: array + description: Filter arrays that have overlapping values with this parameter. + items: + type: string + title: $overlap + description: Filter arrays that have overlapping values with this parameter. + $contains: + type: array + description: Filter arrays that contain some of the values of this parameter. + items: + type: string + title: $contains + description: Filter arrays that contain some of the values of this parameter. + $contained: + type: array + description: Filter arrays that contain all values of this parameter. + items: + type: string + title: $contained + description: Filter arrays that contain all values of this parameter. + $exists: + type: boolean + title: $exists + description: Filter by whether a value for this parameter exists (not `null`). + - name: fields + in: query + description: >- + Comma-separated fields that should be included in the returned data. If + a field is prefixed with `+` it will be added to the default fields, + using `-` will remove it from the default fields. Without prefix it will + replace the entire default fields. + required: false + schema: + type: string + title: fields + description: >- + Comma-separated fields that should be included in the returned data. + If a field is prefixed with `+` it will be added to the default + fields, using `-` will remove it from the default fields. Without + prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + - name: $and + in: query + description: >- + Join query parameters with an AND condition. Each object's content is + the same type as the expected query parameters. + required: false + schema: + type: array + description: >- + Join query parameters with an AND condition. Each object's content is + the same type as the expected query parameters. + items: + type: object + title: $and + - name: $or + in: query + description: >- + Join query parameters with an OR condition. Each object's content is the + same type as the expected query parameters. + required: false + schema: + type: array + description: >- + Join query parameters with an OR condition. Each object's content is + the same type as the expected query parameters. + items: + type: object + title: $or + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + x-codeSamples: + - lang: Shell + label: cURL + source: + $ref: ../code_samples/Shell/admin_views_{entity}_configurations/get.sh + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + allOf: + - type: object + description: The list of view configurations. + required: + - limit + - offset + - count + properties: + limit: + type: number + title: limit + description: The maximum number of returned items. + offset: + type: number + title: offset + description: >- + The number of items skipped before retrieving the returned + items. + count: + type: number + title: count + description: The total number of items. + estimate_count: + type: number + title: estimate_count + description: >- + The estimated count retrieved from the PostgreSQL query + planner, which may be inaccurate. + x-featureFlag: index_engine + - type: object + description: The list of view configurations. + required: + - view_configurations + properties: + view_configurations: + type: array + description: The list of view configurations. + items: + $ref: ../components/schemas/AdminViewConfiguration.yaml + '400': + $ref: ../components/responses/400_error.yaml + '401': + $ref: ../components/responses/unauthorized.yaml + '404': + $ref: ../components/responses/not_found_error.yaml + '409': + $ref: ../components/responses/invalid_state_error.yaml + '422': + $ref: ../components/responses/invalid_request_error.yaml + '500': + $ref: ../components/responses/500_error.yaml + x-since: 2.10.3 + x-featureFlag: view_configurations +post: + operationId: PostViewsEntityConfigurations + summary: Create View Configuration + description: >- + Create a new view configuration for an entity. If `is_system_default` is set + to true, the created configuration will be set as the system default for the + specified entity. Otherwise, it will be a custom configuration for the admin + user. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to create its view configuration (for example, `orders`). + required: true + schema: + type: string + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + requestBody: + content: + application/json: + schema: + $ref: ../components/schemas/AdminCreateViewConfiguration.yaml + x-codeSamples: + - lang: Shell + label: cURL + source: + $ref: ../code_samples/Shell/admin_views_{entity}_configurations/post.sh + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: ../components/schemas/AdminViewConfigurationResponse.yaml + '400': + $ref: ../components/responses/400_error.yaml + '401': + $ref: ../components/responses/unauthorized.yaml + '404': + $ref: ../components/responses/not_found_error.yaml + '409': + $ref: ../components/responses/invalid_state_error.yaml + '422': + $ref: ../components/responses/invalid_request_error.yaml + '500': + $ref: ../components/responses/500_error.yaml + x-workflow: createViewConfigurationWorkflow + x-events: [] + x-since: 2.10.3 + x-featureFlag: view_configurations diff --git a/www/apps/api-reference/specs/admin/paths/admin_views_{entity}_configurations_active.yaml b/www/apps/api-reference/specs/admin/paths/admin_views_{entity}_configurations_active.yaml new file mode 100644 index 0000000000..9db32cf61d --- /dev/null +++ b/www/apps/api-reference/specs/admin/paths/admin_views_{entity}_configurations_active.yaml @@ -0,0 +1,154 @@ +get: + operationId: GetViewsEntityConfigurationsActive + summary: Get Active View Configuration + description: >- + Get the active view configurations for an entity. If no active view is set, + `null` is returned. An admin user can only retrieve their own active + configuration. + x-authenticated: true + parameters: + - name: entity + in: path + description: >- + The entity to retrieve its active view configurations (for example, + `orders`). + required: true + schema: + type: string + - name: fields + in: query + description: >- + Comma-separated fields that should be included in the returned data. If + a field is prefixed with `+` it will be added to the default fields, + using `-` will remove it from the default fields. Without prefix it will + replace the entire default fields. + required: false + schema: + type: string + title: fields + description: >- + Comma-separated fields that should be included in the returned data. + If a field is prefixed with `+` it will be added to the default + fields, using `-` will remove it from the default fields. Without + prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + x-codeSamples: + - lang: Shell + label: cURL + source: + $ref: >- + ../code_samples/Shell/admin_views_{entity}_configurations_active/get.sh + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + allOf: + - $ref: ../components/schemas/AdminViewConfigurationResponse.yaml + - type: object + description: >- + Additional properties related to the active view + configuration. + properties: + is_default_active: + type: boolean + title: is_default_active + description: >- + Whether the active view configuration is the system + default. + default_type: + type: string + description: >- + The type of the default view configuration if the active + view is the system default. It will be `system` if the + active view is the system default, `code` if no active + view is set, or `undefined` if the active view isn't the + system default. + enum: + - code + - system + '400': + $ref: ../components/responses/400_error.yaml + '401': + $ref: ../components/responses/unauthorized.yaml + '404': + $ref: ../components/responses/not_found_error.yaml + '409': + $ref: ../components/responses/invalid_state_error.yaml + '422': + $ref: ../components/responses/invalid_request_error.yaml + '500': + $ref: ../components/responses/500_error.yaml + x-since: 2.10.3 + x-featureFlag: view_configurations +post: + operationId: PostViewsEntityConfigurationsActive + summary: Make View Configuration Active + description: >- + Make a view configuration active. This will set the given view configuration + as the active one for the specified entity for the admin user. An admin user + can only set their own configurations as active. If the view configuration + ID is `null`, the active view configuration will be cleared, and the `code` + or system default view configuration type will be used as the active view. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to update its view configuration (for example, `orders`). + required: true + schema: + type: string + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + requestBody: + content: + application/json: + schema: + $ref: ../components/schemas/AdminSetActiveViewConfiguration.yaml + x-codeSamples: + - lang: Shell + label: cURL + source: + $ref: >- + ../code_samples/Shell/admin_views_{entity}_configurations_active/post.sh + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + description: The details of the operation. + required: + - success + properties: + success: + type: boolean + title: success + description: Whether the operation was successful. + '400': + $ref: ../components/responses/400_error.yaml + '401': + $ref: ../components/responses/unauthorized.yaml + '404': + $ref: ../components/responses/not_found_error.yaml + '409': + $ref: ../components/responses/invalid_state_error.yaml + '422': + $ref: ../components/responses/invalid_request_error.yaml + '500': + $ref: ../components/responses/500_error.yaml + x-since: 2.10.3 + x-featureFlag: view_configurations diff --git a/www/apps/api-reference/specs/admin/paths/admin_views_{entity}_configurations_{id}.yaml b/www/apps/api-reference/specs/admin/paths/admin_views_{entity}_configurations_{id}.yaml new file mode 100644 index 0000000000..5116a22c5a --- /dev/null +++ b/www/apps/api-reference/specs/admin/paths/admin_views_{entity}_configurations_{id}.yaml @@ -0,0 +1,201 @@ +get: + operationId: GetViewsEntityConfigurationsId + summary: Get View Configuration + description: >- + Retrieve a view configuration for an entity. An admin user can only retrieve + their own configurations. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to retrieve its view configurations (for example, `orders`) + required: true + schema: + type: string + - name: id + in: path + description: The ID of the view configuration to retrieve. + required: true + schema: + type: string + - name: fields + in: query + description: >- + Comma-separated fields that should be included in the returned data. If + a field is prefixed with `+` it will be added to the default fields, + using `-` will remove it from the default fields. Without prefix it will + replace the entire default fields. + required: false + schema: + type: string + title: fields + description: >- + Comma-separated fields that should be included in the returned data. + If a field is prefixed with `+` it will be added to the default + fields, using `-` will remove it from the default fields. Without + prefix it will replace the entire default fields. + externalDocs: + url: '#select-fields-and-relations' + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + x-codeSamples: + - lang: Shell + label: cURL + source: + $ref: ../code_samples/Shell/admin_views_{entity}_configurations_{id}/get.sh + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: ../components/schemas/AdminViewConfigurationResponse.yaml + '400': + $ref: ../components/responses/400_error.yaml + '401': + $ref: ../components/responses/unauthorized.yaml + '404': + $ref: ../components/responses/not_found_error.yaml + '409': + $ref: ../components/responses/invalid_state_error.yaml + '422': + $ref: ../components/responses/invalid_request_error.yaml + '500': + $ref: ../components/responses/500_error.yaml + x-since: 2.10.3 + x-featureFlag: view_configurations +post: + operationId: PostViewsEntityConfigurationsId + summary: Update View Configuration + description: >- + Update the view configuration of an entity. An admin user can only update + their own configurations. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to update its view configuration (for example, `orders`). + required: true + schema: + type: string + - name: id + in: path + description: The view configuration's ID. + required: true + schema: + type: string + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + requestBody: + content: + application/json: + schema: + $ref: ../components/schemas/AdminUpdateViewConfiguration.yaml + x-codeSamples: + - lang: Shell + label: cURL + source: + $ref: ../code_samples/Shell/admin_views_{entity}_configurations_{id}/post.sh + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: ../components/schemas/AdminViewConfigurationResponse.yaml + '400': + $ref: ../components/responses/400_error.yaml + '401': + $ref: ../components/responses/unauthorized.yaml + '404': + $ref: ../components/responses/not_found_error.yaml + '409': + $ref: ../components/responses/invalid_state_error.yaml + '422': + $ref: ../components/responses/invalid_request_error.yaml + '500': + $ref: ../components/responses/500_error.yaml + x-workflow: updateViewConfigurationWorkflow + x-events: [] + x-since: 2.10.3 + x-featureFlag: view_configurations +delete: + operationId: DeleteViewsEntityConfigurationsId + summary: Remove View Configurations + description: >- + Remove view configurations of an entity. An admin user can only delete their + own configurations. + x-authenticated: true + parameters: + - name: entity + in: path + description: The entity to delete its view configuration (for example, `orders`) + required: true + schema: + type: string + - name: id + in: path + description: The ID of the view configuration to delete + required: true + schema: + type: string + security: + - api_token: [] + - cookie_auth: [] + - jwt_token: [] + x-codeSamples: + - lang: Shell + label: cURL + source: + $ref: >- + ../code_samples/Shell/admin_views_{entity}_configurations_{id}/delete.sh + tags: + - Views + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + description: The details of the deletion operation. + required: + - id + - object + - deleted + properties: + id: + type: string + title: id + description: The ID of the deleted View Configuration. + object: + type: string + title: object + description: The name of the deleted object. + example: view_configuration + deleted: + type: boolean + title: deleted + description: Whether the view was deleted. + '400': + $ref: ../components/responses/400_error.yaml + '401': + $ref: ../components/responses/unauthorized.yaml + '404': + $ref: ../components/responses/not_found_error.yaml + '409': + $ref: ../components/responses/invalid_state_error.yaml + '422': + $ref: ../components/responses/invalid_request_error.yaml + '500': + $ref: ../components/responses/500_error.yaml + x-since: 2.10.3 + x-featureFlag: view_configurations diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminColumn.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminColumn.yaml new file mode 100644 index 0000000000..4cc9108f45 --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/AdminColumn.yaml @@ -0,0 +1,118 @@ +type: object +description: The details of a column in a view configuration. +x-schemaName: AdminColumn +required: + - id + - name + - field + - sortable + - hideable + - default_visible + - data_type +properties: + id: + type: string + title: id + description: The column's ID. + name: + type: string + title: name + description: The column's name. This is displayed in the view header. + description: + type: string + title: description + description: The column's description. + field: + type: string + title: field + description: The column's field in the entity. + sortable: + type: boolean + title: sortable + description: Whether the column is sortable. + hideable: + type: boolean + title: hideable + description: Whether the column is hideable. + default_visible: + type: boolean + title: default_visible + description: Whether the column is visible by default. + data_type: + type: string + description: The data type of the column's value. + enum: + - string + - number + - boolean + - object + - date + - currency + - enum + semantic_type: + type: string + title: semantic_type + description: >- + The column's semantic type. It can be `computed`, or other primitive + types. + context: + type: string + title: context + description: The column's context. It can be `display` or `generic`. + computed: + type: object + description: >- + A computed column's details. Only available if the column's + `semantic_type` is `computed`. + required: + - type + - required_fields + - optional_fields + properties: + type: + type: string + title: type + description: The computed's type for rendering. + required_fields: + type: array + description: The required fields in the computed column. + items: + type: string + title: required_fields + description: A required field in the computed column. + optional_fields: + type: array + description: The optional fields in the computed column. + items: + type: string + title: optional_fields + description: An optional field in the computed column. + relationship: + type: object + description: The relationship details. Only available for relationship columns. + required: + - entity + - field + properties: + entity: + type: string + title: entity + description: The related entity. + field: + type: string + title: field + description: The field in the related entity. + default_order: + type: number + title: default_order + description: The column's sort order in the default view configuration. + category: + type: string + description: The column's category. + enum: + - status + - metadata + - identifier + - timestamp + - metric + - relationship diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminCreateViewConfiguration.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminCreateViewConfiguration.yaml new file mode 100644 index 0000000000..891034e6f1 --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/AdminCreateViewConfiguration.yaml @@ -0,0 +1,64 @@ +type: object +description: The details of a view configuration to create. +x-schemaName: AdminCreateViewConfiguration +properties: + is_system_default: + type: boolean + title: is_system_default + description: >- + Whether the view is the system default. If so, it will be used as the + default view for all users that don't have a custom active view set. + set_active: + type: boolean + title: set_active + description: Whether the view is set as active. + configuration: + type: object + description: The view's configuration. + required: + - visible_columns + - column_order + properties: + visible_columns: + type: array + description: The configuration's visible columns. + items: + type: string + title: visible_columns + description: The visible column's name. + column_order: + type: array + description: The columns in the order they should be displayed. + items: + type: string + title: column_order + description: The column's name. + search: + type: string + title: search + description: The search query used in the view. + column_widths: + type: object + description: The column widths in the view. + filters: + type: object + description: The filters applied to the view. + sorting: + type: object + description: The sorting applied to the view. + required: + - id + - desc + properties: + id: + type: string + title: id + description: The ID of the sorting column. + desc: + type: boolean + title: desc + description: Whether the sorting is descending. + name: + type: string + title: name + description: The view's name. diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminPostExchangesReturnRequestItemsReqSchema.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminPostExchangesReturnRequestItemsReqSchema.yaml index 0149dfd44a..9056f17eb7 100644 --- a/www/apps/api-reference/specs/store/components/schemas/AdminPostExchangesReturnRequestItemsReqSchema.yaml +++ b/www/apps/api-reference/specs/store/components/schemas/AdminPostExchangesReturnRequestItemsReqSchema.yaml @@ -38,3 +38,7 @@ properties: externalDocs: url: https://docs.medusajs.com/api/admin#manage-metadata description: Learn how to manage metadata + location_id: + type: string + title: location_id + description: The ID of the location to which outbound items are sent from. diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminSetActiveViewConfiguration.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminSetActiveViewConfiguration.yaml new file mode 100644 index 0000000000..1749cb7ff9 --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/AdminSetActiveViewConfiguration.yaml @@ -0,0 +1,13 @@ +type: object +description: The details of a view configuration to set as active for the given entity. +x-schemaName: AdminSetActiveViewConfiguration +required: + - view_configuration_id +properties: + view_configuration_id: + type: string + title: view_configuration_id + description: >- + The ID of the view configuration to set as active. If `null`, the active + view configuration will be cleared, and the `code` or system default view + configuration will be used as the active view. diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminUpdateViewConfiguration.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminUpdateViewConfiguration.yaml new file mode 100644 index 0000000000..03f05930b3 --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/AdminUpdateViewConfiguration.yaml @@ -0,0 +1,59 @@ +type: object +description: The details to update in a view configuration. +x-schemaName: AdminUpdateViewConfiguration +properties: + set_active: + type: boolean + title: set_active + description: Whether the view is set as active. + name: + type: string + title: name + description: The view's name. + is_system_default: + type: boolean + title: is_system_default + description: Whether the view is the system default. + configuration: + type: object + description: The view's configuration. + properties: + search: + type: string + title: search + description: The search query used in the view. + visible_columns: + type: array + description: The configuration's visible columns. + items: + type: string + title: visible_columns + description: The visible column's name. + column_order: + type: array + description: The columns in the order they should be displayed. + items: + type: string + title: column_order + description: The column's name. + column_widths: + type: object + description: The column widths in the view. + filters: + type: object + description: The filters applied to the view. + sorting: + type: object + description: The sorting applied to the view. + required: + - id + - desc + properties: + id: + type: string + title: id + description: The ID of the sorting column. + desc: + type: boolean + title: desc + description: Whether the sorting is descending. diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminViewConfiguration.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminViewConfiguration.yaml new file mode 100644 index 0000000000..cc13b3372c --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/AdminViewConfiguration.yaml @@ -0,0 +1,90 @@ +type: object +description: The details of a view configuration. +x-schemaName: AdminViewConfiguration +required: + - id + - entity + - name + - user_id + - is_system_default + - created_at + - updated_at +properties: + id: + type: string + title: id + description: The view configuration's ID. + entity: + type: string + title: entity + description: The entity the view configuration belongs to. + name: + type: string + title: name + description: The view configuration's name. + user_id: + type: string + title: user_id + description: >- + The ID of the user the view configuration belongs to. If `null`, the view + configuration is a system default. + is_system_default: + type: boolean + title: is_system_default + description: Whether the view configuration is the system default. + configuration: + type: object + description: The view's configuration. + required: + - visible_columns + - column_order + properties: + visible_columns: + type: array + description: The configuration's visible columns. + items: + type: string + title: visible_columns + description: The visible column's name. + column_order: + type: array + description: The columns in the order they should be displayed. + items: + type: string + title: column_order + description: The column's name. + column_widths: + type: object + description: The column widths in the view. + filters: + type: object + description: The filters applied to the view. + sorting: + type: object + description: The sorting applied to the view. + required: + - id + - desc + properties: + id: + type: string + title: id + description: The ID of the sorting column. + desc: + type: boolean + title: desc + description: Whether the sorting is descending. + search: + type: string + title: search + description: The configuration's search. + created_at: + type: string + format: date-time + title: created_at + description: The date the view configuration was created. + updated_at: + type: string + format: date-time + title: updated_at + description: The date the view configuration was updated. diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminViewConfigurationResponse.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminViewConfigurationResponse.yaml new file mode 100644 index 0000000000..52b739ad6a --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/AdminViewConfigurationResponse.yaml @@ -0,0 +1,8 @@ +type: object +description: The details of a view configuration. +x-schemaName: AdminViewConfigurationResponse +required: + - view_configuration +properties: + view_configuration: + $ref: ./AdminViewConfiguration.yaml diff --git a/www/apps/api-reference/specs/store/components/schemas/AdminViewsEntityColumnsResponse.yaml b/www/apps/api-reference/specs/store/components/schemas/AdminViewsEntityColumnsResponse.yaml new file mode 100644 index 0000000000..8823b6120f --- /dev/null +++ b/www/apps/api-reference/specs/store/components/schemas/AdminViewsEntityColumnsResponse.yaml @@ -0,0 +1,11 @@ +type: object +description: The view's columns. +x-schemaName: AdminViewsEntityColumnsResponse +required: + - columns +properties: + columns: + type: array + description: The view's columns. + items: + $ref: ./AdminColumn.yaml diff --git a/www/apps/api-reference/specs/store/components/schemas/StoreAddCartLineItem.yaml b/www/apps/api-reference/specs/store/components/schemas/StoreAddCartLineItem.yaml deleted file mode 100644 index b967a3087e..0000000000 --- a/www/apps/api-reference/specs/store/components/schemas/StoreAddCartLineItem.yaml +++ /dev/null @@ -1,21 +0,0 @@ -type: object -description: The details of the line item to add. -x-schemaName: StoreAddCartLineItem -required: - - variant_id - - quantity -properties: - variant_id: - type: string - title: variant_id - description: The ID of the product variant to add to the cart. - quantity: - type: number - title: quantity - description: The item's quantity. - metadata: - type: object - description: The item's metadata, can hold custom key-value pairs. - externalDocs: - url: https://docs.medusajs.com/api/store#manage-metadata - description: Learn how to manage metadata diff --git a/www/apps/api-reference/specs/store/components/schemas/StoreAddCartShippingMethods.yaml b/www/apps/api-reference/specs/store/components/schemas/StoreAddCartShippingMethods.yaml deleted file mode 100644 index 494a059031..0000000000 --- a/www/apps/api-reference/specs/store/components/schemas/StoreAddCartShippingMethods.yaml +++ /dev/null @@ -1,19 +0,0 @@ -type: object -description: The shipping method's details. -required: - - option_id -properties: - option_id: - type: string - title: option_id - description: The ID of the shipping option this method is created from. - data: - type: object - description: >- - Any additional data relevant for the third-party fulfillment provider to - process the shipment. - externalDocs: - url: >- - https://docs.medusajs.com/v2/resources/storefront-development/checkout/shipping#data-request-body-parameter - description: Learn more about the data parameter. -x-schemaName: StoreAddCartShippingMethods diff --git a/www/apps/api-reference/specs/store/components/schemas/StoreUpdateCartLineItem.yaml b/www/apps/api-reference/specs/store/components/schemas/StoreUpdateCartLineItem.yaml deleted file mode 100644 index dc31e201cc..0000000000 --- a/www/apps/api-reference/specs/store/components/schemas/StoreUpdateCartLineItem.yaml +++ /dev/null @@ -1,16 +0,0 @@ -type: object -description: The details to update in the line item. -x-schemaName: StoreUpdateCartLineItem -required: - - quantity -properties: - quantity: - type: number - title: quantity - description: The item's quantity. - metadata: - type: object - description: The item's metadata, can hold custom key-value pairs. - externalDocs: - url: https://docs.medusajs.com/api/store#manage-metadata - description: Learn how to manage metadata diff --git a/www/apps/api-reference/specs/store/openapi.full.yaml b/www/apps/api-reference/specs/store/openapi.full.yaml index b3d36cd2f2..b4cda529bc 100644 --- a/www/apps/api-reference/specs/store/openapi.full.yaml +++ b/www/apps/api-reference/specs/store/openapi.full.yaml @@ -1366,6 +1366,16 @@ paths: security: - cookie_auth: [] - jwt_token: [] + requestBody: + content: + application/json: + schema: + type: object + description: Optional additional data to pass to the underlying workflow. + properties: + additional_data: + type: object + description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. /store/carts/{id}/gift-cards: post: operationId: PostCartsIdGiftCards @@ -1556,7 +1566,31 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/StoreAddCartLineItem' + allOf: + - type: object + description: The details of the line item to add. + required: + - variant_id + - quantity + properties: + variant_id: + type: string + title: variant_id + description: The ID of the product variant to add as a line item. + quantity: + type: number + title: quantity + description: The item's quantity. + metadata: + type: object + description: The item's metadata, can hold custom key-value pairs. + - type: object + description: The details of the line item to add. + properties: + additional_data: + type: object + description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. + description: The details of the line item to add. x-codeSamples: - lang: JavaScript label: JS SDK @@ -1670,7 +1704,26 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/StoreUpdateCartLineItem' + allOf: + - type: object + description: The details to update in the line item. + required: + - quantity + properties: + quantity: + type: number + title: quantity + description: The item's quantity. + metadata: + type: object + description: The item's metadata, can hold custom key-value pairs. + - type: object + description: The details to update in the line item. + properties: + additional_data: + type: object + description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. + description: The details to update in the line item. x-codeSamples: - lang: JavaScript label: JS SDK @@ -2052,7 +2105,29 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/StoreAddCartShippingMethods' + allOf: + - type: object + description: The shipping method's details. + required: + - option_id + properties: + option_id: + type: string + title: option_id + description: The ID of the shipping option to create the shipping method from. + data: + type: object + description: Any additional data relevant for the third-party fulfillment provider to process the shipment. + externalDocs: + url: https://docs.medusajs.com/resources/storefront-development/checkout/shipping#data-request-body-parameter + description: Learn more about the data parameter. + - type: object + description: The shipping method's details. + properties: + additional_data: + type: object + description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. + description: The shipping method's details. x-codeSamples: - lang: JavaScript label: JS SDK @@ -10786,6 +10861,121 @@ components: properties: collection: $ref: '#/components/schemas/AdminCollection' + AdminColumn: + type: object + description: The details of a column in a view configuration. + x-schemaName: AdminColumn + required: + - id + - name + - field + - sortable + - hideable + - default_visible + - data_type + properties: + id: + type: string + title: id + description: The column's ID. + name: + type: string + title: name + description: The column's name. This is displayed in the view header. + description: + type: string + title: description + description: The column's description. + field: + type: string + title: field + description: The column's field in the entity. + sortable: + type: boolean + title: sortable + description: Whether the column is sortable. + hideable: + type: boolean + title: hideable + description: Whether the column is hideable. + default_visible: + type: boolean + title: default_visible + description: Whether the column is visible by default. + data_type: + type: string + description: The data type of the column's value. + enum: + - string + - number + - boolean + - object + - date + - currency + - enum + semantic_type: + type: string + title: semantic_type + description: The column's semantic type. It can be `computed`, or other primitive types. + context: + type: string + title: context + description: The column's context. It can be `display` or `generic`. + computed: + type: object + description: A computed column's details. Only available if the column's `semantic_type` is `computed`. + required: + - type + - required_fields + - optional_fields + properties: + type: + type: string + title: type + description: The computed's type for rendering. + required_fields: + type: array + description: The required fields in the computed column. + items: + type: string + title: required_fields + description: A required field in the computed column. + optional_fields: + type: array + description: The optional fields in the computed column. + items: + type: string + title: optional_fields + description: An optional field in the computed column. + relationship: + type: object + description: The relationship details. Only available for relationship columns. + required: + - entity + - field + properties: + entity: + type: string + title: entity + description: The related entity. + field: + type: string + title: field + description: The field in the related entity. + default_order: + type: number + title: default_order + description: The column's sort order in the default view configuration. + category: + type: string + description: The column's category. + enum: + - status + - metadata + - identifier + - timestamp + - metric + - relationship AdminCreateApiKey: type: object description: The API key's details. @@ -12447,6 +12637,69 @@ components: type: string title: inventory_item_id description: The inventory item's ID. + AdminCreateViewConfiguration: + type: object + description: The details of a view configuration to create. + x-schemaName: AdminCreateViewConfiguration + properties: + is_system_default: + type: boolean + title: is_system_default + description: Whether the view is the system default. If so, it will be used as the default view for all users that don't have a custom active view set. + set_active: + type: boolean + title: set_active + description: Whether the view is set as active. + configuration: + type: object + description: The view's configuration. + required: + - visible_columns + - column_order + properties: + visible_columns: + type: array + description: The configuration's visible columns. + items: + type: string + title: visible_columns + description: The visible column's name. + column_order: + type: array + description: The columns in the order they should be displayed. + items: + type: string + title: column_order + description: The column's name. + search: + type: string + title: search + description: The search query used in the view. + column_widths: + type: object + description: The column widths in the view. + filters: + type: object + description: The filters applied to the view. + sorting: + type: object + description: The sorting applied to the view. + required: + - id + - desc + properties: + id: + type: string + title: id + description: The ID of the sorting column. + desc: + type: boolean + title: desc + description: Whether the sorting is descending. + name: + type: string + title: name + description: The view's name. AdminCreateWorkflowsAsyncResponse: type: object description: The details of changing a workflow execution's step status. @@ -18054,6 +18307,10 @@ components: externalDocs: url: https://docs.medusajs.com/api/admin#manage-metadata description: Learn how to manage metadata + location_id: + type: string + title: location_id + description: The ID of the location to which outbound items are sent from. AdminPostExchangesShippingActionReqSchema: type: object description: The details of the shipping method to update. @@ -20956,6 +21213,17 @@ components: properties: service_zone: $ref: '#/components/schemas/AdminServiceZone' + AdminSetActiveViewConfiguration: + type: object + description: The details of a view configuration to set as active for the given entity. + x-schemaName: AdminSetActiveViewConfiguration + required: + - view_configuration_id + properties: + view_configuration_id: + type: string + title: view_configuration_id + description: The ID of the view configuration to set as active. If `null`, the active view configuration will be cleared, and the `code` or system default view configuration will be used as the active view. AdminShippingOption: type: object description: The shipping option's details. @@ -23820,6 +24088,66 @@ components: type: number title: required_quantity description: The number of units a single quantity is equivalent to. For example, if a customer orders one quantity of the variant, Medusa checks the availability of the quantity multiplied by the value set for `required_quantity`. When the customer orders the quantity, Medusa reserves the ordered quantity multiplied by the value set for `required_quantity`. + AdminUpdateViewConfiguration: + type: object + description: The details to update in a view configuration. + x-schemaName: AdminUpdateViewConfiguration + properties: + set_active: + type: boolean + title: set_active + description: Whether the view is set as active. + name: + type: string + title: name + description: The view's name. + is_system_default: + type: boolean + title: is_system_default + description: Whether the view is the system default. + configuration: + type: object + description: The view's configuration. + properties: + search: + type: string + title: search + description: The search query used in the view. + visible_columns: + type: array + description: The configuration's visible columns. + items: + type: string + title: visible_columns + description: The visible column's name. + column_order: + type: array + description: The columns in the order they should be displayed. + items: + type: string + title: column_order + description: The column's name. + column_widths: + type: object + description: The column widths in the view. + filters: + type: object + description: The filters applied to the view. + sorting: + type: object + description: The sorting applied to the view. + required: + - id + - desc + properties: + id: + type: string + title: id + description: The ID of the sorting column. + desc: + type: boolean + title: desc + description: Whether the sorting is descending. AdminUploadPreSignedUrl: type: object description: The details of the file to upload. @@ -24051,6 +24379,116 @@ components: properties: user: $ref: '#/components/schemas/AdminUser' + AdminViewConfiguration: + type: object + description: The details of a view configuration. + x-schemaName: AdminViewConfiguration + required: + - id + - entity + - name + - user_id + - is_system_default + - created_at + - updated_at + properties: + id: + type: string + title: id + description: The view configuration's ID. + entity: + type: string + title: entity + description: The entity the view configuration belongs to. + name: + type: string + title: name + description: The view configuration's name. + user_id: + type: string + title: user_id + description: The ID of the user the view configuration belongs to. If `null`, the view configuration is a system default. + is_system_default: + type: boolean + title: is_system_default + description: Whether the view configuration is the system default. + configuration: + type: object + description: The view's configuration. + required: + - visible_columns + - column_order + properties: + visible_columns: + type: array + description: The configuration's visible columns. + items: + type: string + title: visible_columns + description: The visible column's name. + column_order: + type: array + description: The columns in the order they should be displayed. + items: + type: string + title: column_order + description: The column's name. + column_widths: + type: object + description: The column widths in the view. + filters: + type: object + description: The filters applied to the view. + sorting: + type: object + description: The sorting applied to the view. + required: + - id + - desc + properties: + id: + type: string + title: id + description: The ID of the sorting column. + desc: + type: boolean + title: desc + description: Whether the sorting is descending. + search: + type: string + title: search + description: The configuration's search. + created_at: + type: string + format: date-time + title: created_at + description: The date the view configuration was created. + updated_at: + type: string + format: date-time + title: updated_at + description: The date the view configuration was updated. + AdminViewConfigurationResponse: + type: object + description: The details of a view configuration. + x-schemaName: AdminViewConfigurationResponse + required: + - view_configuration + properties: + view_configuration: + $ref: '#/components/schemas/AdminViewConfiguration' + AdminViewsEntityColumnsResponse: + type: object + description: The view's columns. + x-schemaName: AdminViewsEntityColumnsResponse + required: + - columns + properties: + columns: + type: array + description: The view's columns. + items: + $ref: '#/components/schemas/AdminColumn' AdminWorkflowExecution: type: object description: The workflows execution's details. @@ -30050,45 +30488,6 @@ components: type: string title: token description: The order transfer's token issued when the transfer was requested. - StoreAddCartLineItem: - type: object - description: The details of the line item to add. - x-schemaName: StoreAddCartLineItem - required: - - variant_id - - quantity - properties: - variant_id: - type: string - title: variant_id - description: The ID of the product variant to add to the cart. - quantity: - type: number - title: quantity - description: The item's quantity. - metadata: - type: object - description: The item's metadata, can hold custom key-value pairs. - externalDocs: - url: https://docs.medusajs.com/api/store#manage-metadata - description: Learn how to manage metadata - StoreAddCartShippingMethods: - type: object - description: The shipping method's details. - required: - - option_id - properties: - option_id: - type: string - title: option_id - description: The ID of the shipping option this method is created from. - data: - type: object - description: Any additional data relevant for the third-party fulfillment provider to process the shipment. - externalDocs: - url: https://docs.medusajs.com/v2/resources/storefront-development/checkout/shipping#data-request-body-parameter - description: Learn more about the data parameter. - x-schemaName: StoreAddCartShippingMethods StoreAddGiftCardToCart: type: object description: The details to add a gift card to the cart. @@ -39727,23 +40126,6 @@ components: url: https://docs.medusajs.com/api/store#manage-metadata description: Learn how to manage metadata x-schemaName: StoreTransactionGroup - StoreUpdateCartLineItem: - type: object - description: The details to update in the line item. - x-schemaName: StoreUpdateCartLineItem - required: - - quantity - properties: - quantity: - type: number - title: quantity - description: The item's quantity. - metadata: - type: object - description: The item's metadata, can hold custom key-value pairs. - externalDocs: - url: https://docs.medusajs.com/api/store#manage-metadata - description: Learn how to manage metadata StoreUpdateCustomer: type: object description: The details to update in the customer. diff --git a/www/apps/api-reference/specs/store/paths/store_carts_{id}_customer.yaml b/www/apps/api-reference/specs/store/paths/store_carts_{id}_customer.yaml index 2a5f4d0bf0..50baa3659d 100644 --- a/www/apps/api-reference/specs/store/paths/store_carts_{id}_customer.yaml +++ b/www/apps/api-reference/specs/store/paths/store_carts_{id}_customer.yaml @@ -92,3 +92,16 @@ post: security: - cookie_auth: [] - jwt_token: [] + requestBody: + content: + application/json: + schema: + type: object + description: Optional additional data to pass to the underlying workflow. + properties: + additional_data: + type: object + description: >- + Pass additional custom data to the API route. This data is + passed to the underlying workflow under the `additional_data` + parameter. diff --git a/www/apps/api-reference/specs/store/paths/store_carts_{id}_line-items.yaml b/www/apps/api-reference/specs/store/paths/store_carts_{id}_line-items.yaml index f224c39520..da6d22a7b4 100644 --- a/www/apps/api-reference/specs/store/paths/store_carts_{id}_line-items.yaml +++ b/www/apps/api-reference/specs/store/paths/store_carts_{id}_line-items.yaml @@ -45,7 +45,34 @@ post: content: application/json: schema: - $ref: ../components/schemas/StoreAddCartLineItem.yaml + allOf: + - type: object + description: The details of the line item to add. + required: + - variant_id + - quantity + properties: + variant_id: + type: string + title: variant_id + description: The ID of the product variant to add as a line item. + quantity: + type: number + title: quantity + description: The item's quantity. + metadata: + type: object + description: The item's metadata, can hold custom key-value pairs. + - type: object + description: The details of the line item to add. + properties: + additional_data: + type: object + description: >- + Pass additional custom data to the API route. This data is + passed to the underlying workflow under the + `additional_data` parameter. + description: The details of the line item to add. x-codeSamples: - lang: JavaScript label: JS SDK diff --git a/www/apps/api-reference/specs/store/paths/store_carts_{id}_line-items_{line_id}.yaml b/www/apps/api-reference/specs/store/paths/store_carts_{id}_line-items_{line_id}.yaml index a34e20f595..e8e02ab25f 100644 --- a/www/apps/api-reference/specs/store/paths/store_carts_{id}_line-items_{line_id}.yaml +++ b/www/apps/api-reference/specs/store/paths/store_carts_{id}_line-items_{line_id}.yaml @@ -51,7 +51,29 @@ post: content: application/json: schema: - $ref: ../components/schemas/StoreUpdateCartLineItem.yaml + allOf: + - type: object + description: The details to update in the line item. + required: + - quantity + properties: + quantity: + type: number + title: quantity + description: The item's quantity. + metadata: + type: object + description: The item's metadata, can hold custom key-value pairs. + - type: object + description: The details to update in the line item. + properties: + additional_data: + type: object + description: >- + Pass additional custom data to the API route. This data is + passed to the underlying workflow under the + `additional_data` parameter. + description: The details to update in the line item. x-codeSamples: - lang: JavaScript label: JS SDK diff --git a/www/apps/api-reference/specs/store/paths/store_carts_{id}_shipping-methods.yaml b/www/apps/api-reference/specs/store/paths/store_carts_{id}_shipping-methods.yaml index 989c96b301..b00a96a9e2 100644 --- a/www/apps/api-reference/specs/store/paths/store_carts_{id}_shipping-methods.yaml +++ b/www/apps/api-reference/specs/store/paths/store_carts_{id}_shipping-methods.yaml @@ -47,7 +47,37 @@ post: content: application/json: schema: - $ref: ../components/schemas/StoreAddCartShippingMethods.yaml + allOf: + - type: object + description: The shipping method's details. + required: + - option_id + properties: + option_id: + type: string + title: option_id + description: >- + The ID of the shipping option to create the shipping method + from. + data: + type: object + description: >- + Any additional data relevant for the third-party fulfillment + provider to process the shipment. + externalDocs: + url: >- + https://docs.medusajs.com/resources/storefront-development/checkout/shipping#data-request-body-parameter + description: Learn more about the data parameter. + - type: object + description: The shipping method's details. + properties: + additional_data: + type: object + description: >- + Pass additional custom data to the API route. This data is + passed to the underlying workflow under the + `additional_data` parameter. + description: The shipping method's details. x-codeSamples: - lang: JavaScript label: JS SDK diff --git a/www/utils/generated/events-output.json b/www/utils/generated/events-output.json index 5684cf61fa..22e6bb0768 100644 --- a/www/utils/generated/events-output.json +++ b/www/utils/generated/events-output.json @@ -720,8 +720,8 @@ "description": "Emitted when a payment is captured.", "workflows": [ "capturePaymentWorkflow", - "markPaymentCollectionAsPaid", - "processPaymentWorkflow" + "processPaymentWorkflow", + "markPaymentCollectionAsPaid" ], "deprecated": false }, diff --git a/www/utils/generated/oas-output/base/admin.oas.base.yaml b/www/utils/generated/oas-output/base/admin.oas.base.yaml index 02e228fdfe..e39ed340aa 100644 --- a/www/utils/generated/oas-output/base/admin.oas.base.yaml +++ b/www/utils/generated/oas-output/base/admin.oas.base.yaml @@ -122,8 +122,8 @@ tags: $ref: "#/components/schemas/AdminExchange" - name: Feature Flags description: > - Feature flags are used to enable or disable certain features in your Medusa - application. + Feature flags are used to enable or disable certain features in your + Medusa application. These API routes allow admin users to view feature flags. - name: Fulfillment Providers @@ -481,8 +481,9 @@ tags: x-associatedSchema: $ref: "#/components/schemas/AdminShippingOptionType" description: > - Shipping option types define a group of shipping options with shared shipping characterstics. For example, - you may have "Standard" and "Express" shipping option types. + Shipping option types define a group of shipping options with shared + shipping characterstics. For example, you may have "Standard" and + "Express" shipping option types. These API routes allow admins to manage shipping option types. externalDocs: @@ -648,6 +649,7 @@ tags: url: https://docs.medusajs.com/resources/commerce-modules/user x-associatedSchema: $ref: "#/components/schemas/AdminUser" + - name: Views - name: Workflows Executions description: > These API routes allow you to track workflow executions in your Medusa diff --git a/www/utils/generated/oas-output/operations/admin/delete_admin_views_[entity]_configurations_[id].ts b/www/utils/generated/oas-output/operations/admin/delete_admin_views_[entity]_configurations_[id].ts new file mode 100644 index 0000000000..1ddf1277e7 --- /dev/null +++ b/www/utils/generated/oas-output/operations/admin/delete_admin_views_[entity]_configurations_[id].ts @@ -0,0 +1,74 @@ +/** + * @oas [delete] /admin/views/{entity}/configurations/{id} + * operationId: DeleteViewsEntityConfigurationsId + * summary: Remove View Configurations + * description: Remove view configurations of an entity. An admin user can only delete their own configurations. + * x-authenticated: true + * parameters: + * - name: entity + * in: path + * description: The entity to delete its view configuration (for example, `orders`) + * required: true + * schema: + * type: string + * - name: id + * in: path + * description: The ID of the view configuration to delete + * required: true + * schema: + * type: string + * security: + * - api_token: [] + * - cookie_auth: [] + * - jwt_token: [] + * x-codeSamples: + * - lang: Shell + * label: cURL + * source: |- + * curl -X DELETE '{backend_url}/admin/views/{entity}/configurations/{id}' \ + * -H 'Authorization: Bearer {access_token}' + * tags: + * - Views + * responses: + * "200": + * description: OK + * content: + * application/json: + * schema: + * type: object + * description: The details of the deletion operation. + * required: + * - id + * - object + * - deleted + * properties: + * id: + * type: string + * title: id + * description: The ID of the deleted View Configuration. + * object: + * type: string + * title: object + * description: The name of the deleted object. + * example: view_configuration + * deleted: + * type: boolean + * title: deleted + * description: Whether the view was deleted. + * "400": + * $ref: "#/components/responses/400_error" + * "401": + * $ref: "#/components/responses/unauthorized" + * "404": + * $ref: "#/components/responses/not_found_error" + * "409": + * $ref: "#/components/responses/invalid_state_error" + * "422": + * $ref: "#/components/responses/invalid_request_error" + * "500": + * $ref: "#/components/responses/500_error" + * x-since: 2.10.3 + * x-featureFlag: view_configurations + * +*/ + diff --git a/www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_columns.ts b/www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_columns.ts new file mode 100644 index 0000000000..ac701c537f --- /dev/null +++ b/www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_columns.ts @@ -0,0 +1,50 @@ +/** + * @oas [get] /admin/views/{entity}/columns + * operationId: GetViewsEntityColumns + * summary: List Columns in View + * x-sidebar-summary: List Columns + * description: Retrieve a list of columns in a view for an entity. The columns are retrieved for the authenticated admin user. + * x-authenticated: true + * parameters: + * - name: entity + * in: path + * description: The entity to retrieve its columns (for example, `orders`) + * required: true + * schema: + * type: string + * security: + * - api_token: [] + * - cookie_auth: [] + * - jwt_token: [] + * x-codeSamples: + * - lang: Shell + * label: cURL + * source: |- + * curl '{backend_url}/admin/views/{entity}/columns' \ + * -H 'Authorization: Bearer {access_token}' + * tags: + * - Views + * responses: + * "200": + * description: OK + * content: + * application/json: + * schema: + * $ref: "#/components/schemas/AdminViewsEntityColumnsResponse" + * "400": + * $ref: "#/components/responses/400_error" + * "401": + * $ref: "#/components/responses/unauthorized" + * "404": + * $ref: "#/components/responses/not_found_error" + * "409": + * $ref: "#/components/responses/invalid_state_error" + * "422": + * $ref: "#/components/responses/invalid_request_error" + * "500": + * $ref: "#/components/responses/500_error" + * x-since: 2.10.3 + * x-featureFlag: view_configurations + * +*/ + diff --git a/www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_configurations.ts b/www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_configurations.ts new file mode 100644 index 0000000000..db563a74a9 --- /dev/null +++ b/www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_configurations.ts @@ -0,0 +1,455 @@ +/** + * @oas [get] /admin/views/{entity}/configurations + * operationId: GetViewsEntityConfigurations + * summary: List View Configurations + * description: Retrieve a list of view configurations of an entity. The configurations can be filtered by fields like `id`. The configurations can also be paginated. An admin user can only retrieve their own configurations. + * x-authenticated: true + * parameters: + * - name: entity + * in: path + * description: The entity to retrieve its view configurations (for example, `orders`) + * required: true + * schema: + * type: string + * - name: offset + * in: query + * description: The number of items to skip when retrieving a list. + * required: false + * schema: + * type: number + * title: offset + * description: The number of items to skip when retrieving a list. + * externalDocs: + * url: "#pagination" + * - name: limit + * in: query + * description: Limit the number of items returned in the list. + * required: false + * schema: + * type: number + * title: limit + * description: Limit the number of items returned in the list. + * externalDocs: + * url: "#pagination" + * - name: order + * in: query + * description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + * required: false + * schema: + * type: string + * title: order + * description: The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`. + * externalDocs: + * url: "#pagination" + * - name: with_deleted + * in: query + * description: Whether to include deleted records in the result. + * required: false + * schema: + * type: boolean + * title: with_deleted + * description: Whether to include deleted records in the result. + * - name: id + * in: query + * required: false + * schema: + * oneOf: + * - type: string + * title: id + * description: Filter by a view configuration ID. + * - type: array + * description: Filter by view configuration IDs. + * items: + * type: string + * title: id + * description: The view configuration ID. + * - name: entity + * in: query + * required: false + * schema: + * oneOf: + * - type: string + * title: entity + * description: Filter by an entity. + * - type: array + * description: Filter by entities. + * items: + * type: string + * title: entity + * description: An entity. + * - name: name + * in: query + * required: false + * schema: + * oneOf: + * - type: string + * title: name + * description: Filter by a view's name. + * - type: array + * description: Filter by view names. + * items: + * type: string + * title: name + * description: The view's name. + * - name: user_id + * in: query + * required: false + * schema: + * oneOf: + * - type: string + * title: user_id + * description: Filter by the ID of the user who owns the view. + * - type: array + * description: Filter by the IDs of users who own the view. + * items: + * type: string + * title: user_id + * description: The user ID. + * - name: is_system_default + * in: query + * description: Filter by whether the view is a system default. + * required: false + * schema: + * type: boolean + * title: is_system_default + * description: Whether the view is a system default. + * - name: created_at + * in: query + * description: Filter by a view configuration's creation date. + * required: false + * schema: + * type: object + * description: Filter by a view configuration's creation date. + * properties: + * $and: + * type: array + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $and + * $or: + * type: array + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $or + * $eq: + * oneOf: + * - type: string + * title: $eq + * description: Filter by an exact match. + * - type: array + * description: Filter by an exact match. + * items: + * type: string + * title: $eq + * description: Filter by an exact match. + * $ne: + * type: string + * title: $ne + * description: Filter by values not equal to this parameter. + * $in: + * type: array + * description: Filter by values in this array. + * items: + * type: string + * title: $in + * description: Filter by values in this array. + * $nin: + * type: array + * description: Filter by values not in this array. + * items: + * type: string + * title: $nin + * description: Filter by values not in this array. + * $not: + * oneOf: + * - type: string + * title: $not + * description: Filter by values not matching the conditions in this parameter. + * - type: object + * description: Filter by values not matching the conditions in this parameter. + * - type: array + * description: Filter by values not matching the conditions in this parameter. + * items: + * type: string + * title: $not + * description: Filter by values not matching the conditions in this parameter. + * $gt: + * type: string + * title: $gt + * description: Filter by values greater than this parameter. Useful for numbers and dates only. + * $gte: + * type: string + * title: $gte + * description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + * $lt: + * type: string + * title: $lt + * description: Filter by values less than this parameter. Useful for numbers and dates only. + * $lte: + * type: string + * title: $lte + * description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + * $like: + * type: string + * title: $like + * description: Apply a `like` filter. Useful for strings only. + * $re: + * type: string + * title: $re + * description: Apply a regex filter. Useful for strings only. + * $ilike: + * type: string + * title: $ilike + * description: Apply a case-insensitive `like` filter. Useful for strings only. + * $fulltext: + * type: string + * title: $fulltext + * description: Filter to apply on full-text properties. + * $overlap: + * type: array + * description: Filter arrays that have overlapping values with this parameter. + * items: + * type: string + * title: $overlap + * description: Filter arrays that have overlapping values with this parameter. + * $contains: + * type: array + * description: Filter arrays that contain some of the values of this parameter. + * items: + * type: string + * title: $contains + * description: Filter arrays that contain some of the values of this parameter. + * $contained: + * type: array + * description: Filter arrays that contain all values of this parameter. + * items: + * type: string + * title: $contained + * description: Filter arrays that contain all values of this parameter. + * $exists: + * type: boolean + * title: $exists + * description: Filter by whether a value for this parameter exists (not `null`). + * - name: updated_at + * in: query + * description: Filter by a view configuration's update date. + * required: false + * schema: + * type: object + * description: Filter by a view configuration's update date. + * properties: + * $and: + * type: array + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $and + * $or: + * type: array + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $or + * $eq: + * oneOf: + * - type: string + * title: $eq + * description: Filter by an exact match. + * - type: array + * description: Filter by an exact match. + * items: + * type: string + * title: $eq + * description: Filter by an exact match. + * $ne: + * type: string + * title: $ne + * description: Filter by values not equal to this parameter. + * $in: + * type: array + * description: Filter by values in this array. + * items: + * type: string + * title: $in + * description: Filter by values in this array. + * $nin: + * type: array + * description: Filter by values not in this array. + * items: + * type: string + * title: $nin + * description: Filter by values not in this array. + * $not: + * oneOf: + * - type: string + * title: $not + * description: Filter by values not matching the conditions in this parameter. + * - type: object + * description: Filter by values not matching the conditions in this parameter. + * - type: array + * description: Filter by values not matching the conditions in this parameter. + * items: + * type: string + * title: $not + * description: Filter by values not matching the conditions in this parameter. + * $gt: + * type: string + * title: $gt + * description: Filter by values greater than this parameter. Useful for numbers and dates only. + * $gte: + * type: string + * title: $gte + * description: Filter by values greater than or equal to this parameter. Useful for numbers and dates only. + * $lt: + * type: string + * title: $lt + * description: Filter by values less than this parameter. Useful for numbers and dates only. + * $lte: + * type: string + * title: $lte + * description: Filter by values less than or equal to this parameter. Useful for numbers and dates only. + * $like: + * type: string + * title: $like + * description: Apply a `like` filter. Useful for strings only. + * $re: + * type: string + * title: $re + * description: Apply a regex filter. Useful for strings only. + * $ilike: + * type: string + * title: $ilike + * description: Apply a case-insensitive `like` filter. Useful for strings only. + * $fulltext: + * type: string + * title: $fulltext + * description: Filter to apply on full-text properties. + * $overlap: + * type: array + * description: Filter arrays that have overlapping values with this parameter. + * items: + * type: string + * title: $overlap + * description: Filter arrays that have overlapping values with this parameter. + * $contains: + * type: array + * description: Filter arrays that contain some of the values of this parameter. + * items: + * type: string + * title: $contains + * description: Filter arrays that contain some of the values of this parameter. + * $contained: + * type: array + * description: Filter arrays that contain all values of this parameter. + * items: + * type: string + * title: $contained + * description: Filter arrays that contain all values of this parameter. + * $exists: + * type: boolean + * title: $exists + * description: Filter by whether a value for this parameter exists (not `null`). + * - name: fields + * in: query + * description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default + * fields. Without prefix it will replace the entire default fields. + * required: false + * schema: + * type: string + * title: fields + * description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default + * fields. Without prefix it will replace the entire default fields. + * externalDocs: + * url: "#select-fields-and-relations" + * - name: $and + * in: query + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * required: false + * schema: + * type: array + * description: Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $and + * - name: $or + * in: query + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * required: false + * schema: + * type: array + * description: Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters. + * items: + * type: object + * title: $or + * security: + * - api_token: [] + * - cookie_auth: [] + * - jwt_token: [] + * x-codeSamples: + * - lang: Shell + * label: cURL + * source: |- + * curl '{backend_url}/admin/views/{entity}/configurations' \ + * -H 'Authorization: Bearer {access_token}' + * tags: + * - Views + * responses: + * "200": + * description: OK + * content: + * application/json: + * schema: + * allOf: + * - type: object + * description: The list of view configurations. + * required: + * - limit + * - offset + * - count + * properties: + * limit: + * type: number + * title: limit + * description: The maximum number of returned items. + * offset: + * type: number + * title: offset + * description: The number of items skipped before retrieving the returned items. + * count: + * type: number + * title: count + * description: The total number of items. + * estimate_count: + * type: number + * title: estimate_count + * description: The estimated count retrieved from the PostgreSQL query planner, which may be inaccurate. + * x-featureFlag: index_engine + * - type: object + * description: The list of view configurations. + * required: + * - view_configurations + * properties: + * view_configurations: + * type: array + * description: The list of view configurations. + * items: + * $ref: "#/components/schemas/AdminViewConfiguration" + * "400": + * $ref: "#/components/responses/400_error" + * "401": + * $ref: "#/components/responses/unauthorized" + * "404": + * $ref: "#/components/responses/not_found_error" + * "409": + * $ref: "#/components/responses/invalid_state_error" + * "422": + * $ref: "#/components/responses/invalid_request_error" + * "500": + * $ref: "#/components/responses/500_error" + * x-since: 2.10.3 + * x-featureFlag: view_configurations + * +*/ + diff --git a/www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_configurations_[id].ts b/www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_configurations_[id].ts new file mode 100644 index 0000000000..47ba699a41 --- /dev/null +++ b/www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_configurations_[id].ts @@ -0,0 +1,67 @@ +/** + * @oas [get] /admin/views/{entity}/configurations/{id} + * operationId: GetViewsEntityConfigurationsId + * summary: Get View Configuration + * description: Retrieve a view configuration for an entity. An admin user can only retrieve their own configurations. + * x-authenticated: true + * parameters: + * - name: entity + * in: path + * description: The entity to retrieve its view configurations (for example, `orders`) + * required: true + * schema: + * type: string + * - name: id + * in: path + * description: The ID of the view configuration to retrieve. + * required: true + * schema: + * type: string + * - name: fields + * in: query + * description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default + * fields. Without prefix it will replace the entire default fields. + * required: false + * schema: + * type: string + * title: fields + * description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default + * fields. Without prefix it will replace the entire default fields. + * externalDocs: + * url: "#select-fields-and-relations" + * security: + * - api_token: [] + * - cookie_auth: [] + * - jwt_token: [] + * x-codeSamples: + * - lang: Shell + * label: cURL + * source: |- + * curl '{backend_url}/admin/views/{entity}/configurations/{id}' \ + * -H 'Authorization: Bearer {access_token}' + * tags: + * - Views + * responses: + * "200": + * description: OK + * content: + * application/json: + * schema: + * $ref: "#/components/schemas/AdminViewConfigurationResponse" + * "400": + * $ref: "#/components/responses/400_error" + * "401": + * $ref: "#/components/responses/unauthorized" + * "404": + * $ref: "#/components/responses/not_found_error" + * "409": + * $ref: "#/components/responses/invalid_state_error" + * "422": + * $ref: "#/components/responses/invalid_request_error" + * "500": + * $ref: "#/components/responses/500_error" + * x-since: 2.10.3 + * x-featureFlag: view_configurations + * +*/ + diff --git a/www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_configurations_active.ts b/www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_configurations_active.ts new file mode 100644 index 0000000000..88c38ffaeb --- /dev/null +++ b/www/utils/generated/oas-output/operations/admin/get_admin_views_[entity]_configurations_active.ts @@ -0,0 +1,75 @@ +/** + * @oas [get] /admin/views/{entity}/configurations/active + * operationId: GetViewsEntityConfigurationsActive + * summary: Get Active View Configuration + * description: Get the active view configurations for an entity. If no active view is set, `null` is returned. An admin user can only retrieve their own active configuration. + * x-authenticated: true + * parameters: + * - name: entity + * in: path + * description: The entity to retrieve its active view configurations (for example, `orders`). + * required: true + * schema: + * type: string + * - name: fields + * in: query + * description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default + * fields. Without prefix it will replace the entire default fields. + * required: false + * schema: + * type: string + * title: fields + * description: Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default + * fields. Without prefix it will replace the entire default fields. + * externalDocs: + * url: "#select-fields-and-relations" + * security: + * - api_token: [] + * - cookie_auth: [] + * - jwt_token: [] + * x-codeSamples: + * - lang: Shell + * label: cURL + * source: |- + * curl '{backend_url}/admin/views/{entity}/configurations/active' \ + * -H 'Authorization: Bearer {access_token}' + * tags: + * - Views + * responses: + * "200": + * description: OK + * content: + * application/json: + * schema: + * allOf: + * - $ref: "#/components/schemas/AdminViewConfigurationResponse" + * - type: object + * description: Additional properties related to the active view configuration. + * properties: + * is_default_active: + * type: boolean + * title: is_default_active + * description: Whether the active view configuration is the system default. + * default_type: + * type: string + * description: The type of the default view configuration if the active view is the system default. It will be `system` if the active view is the system default, `code` if no active view is set, or `undefined` if the active view isn't the system default. + * enum: + * - code + * - system + * "400": + * $ref: "#/components/responses/400_error" + * "401": + * $ref: "#/components/responses/unauthorized" + * "404": + * $ref: "#/components/responses/not_found_error" + * "409": + * $ref: "#/components/responses/invalid_state_error" + * "422": + * $ref: "#/components/responses/invalid_request_error" + * "500": + * $ref: "#/components/responses/500_error" + * x-since: 2.10.3 + * x-featureFlag: view_configurations + * +*/ + diff --git a/www/utils/generated/oas-output/operations/admin/post_admin_views_[entity]_configurations.ts b/www/utils/generated/oas-output/operations/admin/post_admin_views_[entity]_configurations.ts new file mode 100644 index 0000000000..3e092a454c --- /dev/null +++ b/www/utils/generated/oas-output/operations/admin/post_admin_views_[entity]_configurations.ts @@ -0,0 +1,61 @@ +/** + * @oas [post] /admin/views/{entity}/configurations + * operationId: PostViewsEntityConfigurations + * summary: Create View Configuration + * description: Create a new view configuration for an entity. If `is_system_default` is set to true, the created configuration will be set as the system default for the specified entity. Otherwise, it will be a custom configuration for the admin user. + * x-authenticated: true + * parameters: + * - name: entity + * in: path + * description: The entity to create its view configuration (for example, `orders`). + * required: true + * schema: + * type: string + * security: + * - api_token: [] + * - cookie_auth: [] + * - jwt_token: [] + * requestBody: + * content: + * application/json: + * schema: + * $ref: "#/components/schemas/AdminCreateViewConfiguration" + * x-codeSamples: + * - lang: Shell + * label: cURL + * source: |- + * curl -X POST '{backend_url}/admin/views/{entity}/configurations' \ + * -H 'Authorization: Bearer {access_token}' \ + * -H 'Content-Type: application/json' \ + * -d '{ + * "is_system_default": true, + * "name": "Custom View" + * }' + * tags: + * - Views + * responses: + * "200": + * description: OK + * content: + * application/json: + * schema: + * $ref: "#/components/schemas/AdminViewConfigurationResponse" + * "400": + * $ref: "#/components/responses/400_error" + * "401": + * $ref: "#/components/responses/unauthorized" + * "404": + * $ref: "#/components/responses/not_found_error" + * "409": + * $ref: "#/components/responses/invalid_state_error" + * "422": + * $ref: "#/components/responses/invalid_request_error" + * "500": + * $ref: "#/components/responses/500_error" + * x-workflow: createViewConfigurationWorkflow + * x-events: [] + * x-since: 2.10.3 + * x-featureFlag: view_configurations + * +*/ + diff --git a/www/utils/generated/oas-output/operations/admin/post_admin_views_[entity]_configurations_[id].ts b/www/utils/generated/oas-output/operations/admin/post_admin_views_[entity]_configurations_[id].ts new file mode 100644 index 0000000000..e5b7785877 --- /dev/null +++ b/www/utils/generated/oas-output/operations/admin/post_admin_views_[entity]_configurations_[id].ts @@ -0,0 +1,66 @@ +/** + * @oas [post] /admin/views/{entity}/configurations/{id} + * operationId: PostViewsEntityConfigurationsId + * summary: Update View Configuration + * description: Update the view configuration of an entity. An admin user can only update their own configurations. + * x-authenticated: true + * parameters: + * - name: entity + * in: path + * description: The entity to update its view configuration (for example, `orders`). + * required: true + * schema: + * type: string + * - name: id + * in: path + * description: The view configuration's ID. + * required: true + * schema: + * type: string + * security: + * - api_token: [] + * - cookie_auth: [] + * - jwt_token: [] + * requestBody: + * content: + * application/json: + * schema: + * $ref: "#/components/schemas/AdminUpdateViewConfiguration" + * x-codeSamples: + * - lang: Shell + * label: cURL + * source: |- + * curl -X POST '{backend_url}/admin/views/{entity}/configurations/{id}' \ + * -H 'Authorization: Bearer {access_token}' \ + * -H 'Content-Type: application/json' \ + * -d '{ + * "is_system_default": true + * }' + * tags: + * - Views + * responses: + * "200": + * description: OK + * content: + * application/json: + * schema: + * $ref: "#/components/schemas/AdminViewConfigurationResponse" + * "400": + * $ref: "#/components/responses/400_error" + * "401": + * $ref: "#/components/responses/unauthorized" + * "404": + * $ref: "#/components/responses/not_found_error" + * "409": + * $ref: "#/components/responses/invalid_state_error" + * "422": + * $ref: "#/components/responses/invalid_request_error" + * "500": + * $ref: "#/components/responses/500_error" + * x-workflow: updateViewConfigurationWorkflow + * x-events: [] + * x-since: 2.10.3 + * x-featureFlag: view_configurations + * +*/ + diff --git a/www/utils/generated/oas-output/operations/admin/post_admin_views_[entity]_configurations_active.ts b/www/utils/generated/oas-output/operations/admin/post_admin_views_[entity]_configurations_active.ts new file mode 100644 index 0000000000..e326c28e7d --- /dev/null +++ b/www/utils/generated/oas-output/operations/admin/post_admin_views_[entity]_configurations_active.ts @@ -0,0 +1,66 @@ +/** + * @oas [post] /admin/views/{entity}/configurations/active + * operationId: PostViewsEntityConfigurationsActive + * summary: Make View Configuration Active + * description: Make a view configuration active. This will set the given view configuration as the active one for the specified entity for the admin user. An admin user can only set their own configurations as active. If the view configuration ID is `null`, the active view configuration will be cleared, and the `code` or system default view configuration type will be used as the active view. + * x-authenticated: true + * parameters: + * - name: entity + * in: path + * description: The entity to update its view configuration (for example, `orders`). + * required: true + * schema: + * type: string + * security: + * - api_token: [] + * - cookie_auth: [] + * - jwt_token: [] + * requestBody: + * content: + * application/json: + * schema: + * $ref: "#/components/schemas/AdminSetActiveViewConfiguration" + * x-codeSamples: + * - lang: Shell + * label: cURL + * source: |- + * curl -X POST '{backend_url}/admin/views/{entity}/configurations/active' \ + * -H 'Authorization: Bearer {access_token}' \ + * -H 'Content-Type: application/json' \ + * --data-raw '{ + * "view_configuration_id": "{value}" + * }' + * tags: + * - Views + * responses: + * "200": + * description: OK + * content: + * application/json: + * schema: + * type: object + * description: The details of the operation. + * required: + * - success + * properties: + * success: + * type: boolean + * title: success + * description: Whether the operation was successful. + * "400": + * $ref: "#/components/responses/400_error" + * "401": + * $ref: "#/components/responses/unauthorized" + * "404": + * $ref: "#/components/responses/not_found_error" + * "409": + * $ref: "#/components/responses/invalid_state_error" + * "422": + * $ref: "#/components/responses/invalid_request_error" + * "500": + * $ref: "#/components/responses/500_error" + * x-since: 2.10.3 + * x-featureFlag: view_configurations + * +*/ + diff --git a/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_customer.ts b/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_customer.ts index 59e54f1ded..589ca28d36 100644 --- a/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_customer.ts +++ b/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_customer.ts @@ -103,6 +103,16 @@ * security: * - cookie_auth: [] * - jwt_token: [] - * + * requestBody: + * content: + * application/json: + * schema: + * type: object + * description: Optional additional data to pass to the underlying workflow. + * properties: + * additional_data: + * type: object + * description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. + * */ diff --git a/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_line-items.ts b/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_line-items.ts index 92609a39ea..a181621f6e 100644 --- a/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_line-items.ts +++ b/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_line-items.ts @@ -39,7 +39,31 @@ * content: * application/json: * schema: - * $ref: "#/components/schemas/StoreAddCartLineItem" + * allOf: + * - type: object + * description: The details of the line item to add. + * required: + * - variant_id + * - quantity + * properties: + * variant_id: + * type: string + * title: variant_id + * description: The ID of the product variant to add as a line item. + * quantity: + * type: number + * title: quantity + * description: The item's quantity. + * metadata: + * type: object + * description: The item's metadata, can hold custom key-value pairs. + * - type: object + * description: The details of the line item to add. + * properties: + * additional_data: + * type: object + * description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. + * description: The details of the line item to add. * x-codeSamples: * - lang: JavaScript * label: JS SDK diff --git a/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_line-items_[line_id].ts b/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_line-items_[line_id].ts index 699e0f398c..52b6191843 100644 --- a/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_line-items_[line_id].ts +++ b/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_line-items_[line_id].ts @@ -45,7 +45,26 @@ * content: * application/json: * schema: - * $ref: "#/components/schemas/StoreUpdateCartLineItem" + * allOf: + * - type: object + * description: The details to update in the line item. + * required: + * - quantity + * properties: + * quantity: + * type: number + * title: quantity + * description: The item's quantity. + * metadata: + * type: object + * description: The item's metadata, can hold custom key-value pairs. + * - type: object + * description: The details to update in the line item. + * properties: + * additional_data: + * type: object + * description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. + * description: The details to update in the line item. * x-codeSamples: * - lang: JavaScript * label: JS SDK diff --git a/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_shipping-methods.ts b/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_shipping-methods.ts index e68e9792d2..1900e10303 100644 --- a/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_shipping-methods.ts +++ b/www/utils/generated/oas-output/operations/store/post_store_carts_[id]_shipping-methods.ts @@ -39,7 +39,29 @@ * content: * application/json: * schema: - * $ref: "#/components/schemas/StoreAddCartShippingMethods" + * allOf: + * - type: object + * description: The shipping method's details. + * required: + * - option_id + * properties: + * option_id: + * type: string + * title: option_id + * description: The ID of the shipping option to create the shipping method from. + * data: + * type: object + * description: Any additional data relevant for the third-party fulfillment provider to process the shipment. + * externalDocs: + * url: https://docs.medusajs.com/resources/storefront-development/checkout/shipping#data-request-body-parameter + * description: Learn more about the data parameter. + * - type: object + * description: The shipping method's details. + * properties: + * additional_data: + * type: object + * description: Pass additional custom data to the API route. This data is passed to the underlying workflow under the `additional_data` parameter. + * description: The shipping method's details. * x-codeSamples: * - lang: JavaScript * label: JS SDK diff --git a/www/utils/generated/oas-output/schemas/AdminColumn.ts b/www/utils/generated/oas-output/schemas/AdminColumn.ts new file mode 100644 index 0000000000..9c697c0c75 --- /dev/null +++ b/www/utils/generated/oas-output/schemas/AdminColumn.ts @@ -0,0 +1,119 @@ +/** + * @schema AdminColumn + * type: object + * description: The details of a column in a view configuration. + * x-schemaName: AdminColumn + * required: + * - id + * - name + * - field + * - sortable + * - hideable + * - default_visible + * - data_type + * properties: + * id: + * type: string + * title: id + * description: The column's ID. + * name: + * type: string + * title: name + * description: The column's name. This is displayed in the view header. + * description: + * type: string + * title: description + * description: The column's description. + * field: + * type: string + * title: field + * description: The column's field in the entity. + * sortable: + * type: boolean + * title: sortable + * description: Whether the column is sortable. + * hideable: + * type: boolean + * title: hideable + * description: Whether the column is hideable. + * default_visible: + * type: boolean + * title: default_visible + * description: Whether the column is visible by default. + * data_type: + * type: string + * description: The data type of the column's value. + * enum: + * - string + * - number + * - boolean + * - object + * - date + * - currency + * - enum + * semantic_type: + * type: string + * title: semantic_type + * description: The column's semantic type. It can be `computed`, or other primitive types. + * context: + * type: string + * title: context + * description: The column's context. It can be `display` or `generic`. + * computed: + * type: object + * description: A computed column's details. Only available if the column's `semantic_type` is `computed`. + * required: + * - type + * - required_fields + * - optional_fields + * properties: + * type: + * type: string + * title: type + * description: The computed's type for rendering. + * required_fields: + * type: array + * description: The required fields in the computed column. + * items: + * type: string + * title: required_fields + * description: A required field in the computed column. + * optional_fields: + * type: array + * description: The optional fields in the computed column. + * items: + * type: string + * title: optional_fields + * description: An optional field in the computed column. + * relationship: + * type: object + * description: The relationship details. Only available for relationship columns. + * required: + * - entity + * - field + * properties: + * entity: + * type: string + * title: entity + * description: The related entity. + * field: + * type: string + * title: field + * description: The field in the related entity. + * default_order: + * type: number + * title: default_order + * description: The column's sort order in the default view configuration. + * category: + * type: string + * description: The column's category. + * enum: + * - status + * - metadata + * - identifier + * - timestamp + * - metric + * - relationship + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/AdminCreateViewConfiguration.ts b/www/utils/generated/oas-output/schemas/AdminCreateViewConfiguration.ts new file mode 100644 index 0000000000..01f9ce4fd1 --- /dev/null +++ b/www/utils/generated/oas-output/schemas/AdminCreateViewConfiguration.ts @@ -0,0 +1,67 @@ +/** + * @schema AdminCreateViewConfiguration + * type: object + * description: The details of a view configuration to create. + * x-schemaName: AdminCreateViewConfiguration + * properties: + * is_system_default: + * type: boolean + * title: is_system_default + * description: Whether the view is the system default. If so, it will be used as the default view for all users that don't have a custom active view set. + * set_active: + * type: boolean + * title: set_active + * description: Whether the view is set as active. + * configuration: + * type: object + * description: The view's configuration. + * required: + * - visible_columns + * - column_order + * properties: + * visible_columns: + * type: array + * description: The configuration's visible columns. + * items: + * type: string + * title: visible_columns + * description: The visible column's name. + * column_order: + * type: array + * description: The columns in the order they should be displayed. + * items: + * type: string + * title: column_order + * description: The column's name. + * search: + * type: string + * title: search + * description: The search query used in the view. + * column_widths: + * type: object + * description: The column widths in the view. + * filters: + * type: object + * description: The filters applied to the view. + * sorting: + * type: object + * description: The sorting applied to the view. + * required: + * - id + * - desc + * properties: + * id: + * type: string + * title: id + * description: The ID of the sorting column. + * desc: + * type: boolean + * title: desc + * description: Whether the sorting is descending. + * name: + * type: string + * title: name + * description: The view's name. + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/AdminPostExchangesReturnRequestItemsReqSchema.ts b/www/utils/generated/oas-output/schemas/AdminPostExchangesReturnRequestItemsReqSchema.ts index 02497b4dcb..6014ed5447 100644 --- a/www/utils/generated/oas-output/schemas/AdminPostExchangesReturnRequestItemsReqSchema.ts +++ b/www/utils/generated/oas-output/schemas/AdminPostExchangesReturnRequestItemsReqSchema.ts @@ -40,6 +40,10 @@ * externalDocs: * url: https://docs.medusajs.com/api/admin#manage-metadata * description: Learn how to manage metadata + * location_id: + * type: string + * title: location_id + * description: The ID of the location to which outbound items are sent from. * */ diff --git a/www/utils/generated/oas-output/schemas/AdminSetActiveViewConfiguration.ts b/www/utils/generated/oas-output/schemas/AdminSetActiveViewConfiguration.ts new file mode 100644 index 0000000000..b4c467e113 --- /dev/null +++ b/www/utils/generated/oas-output/schemas/AdminSetActiveViewConfiguration.ts @@ -0,0 +1,15 @@ +/** + * @schema AdminSetActiveViewConfiguration + * type: object + * description: The details of a view configuration to set as active for the given entity. + * x-schemaName: AdminSetActiveViewConfiguration + * required: + * - view_configuration_id + * properties: + * view_configuration_id: + * type: string + * title: view_configuration_id + * description: The ID of the view configuration to set as active. If `null`, the active view configuration will be cleared, and the `code` or system default view configuration will be used as the active view. + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/AdminUpdateViewConfiguration.ts b/www/utils/generated/oas-output/schemas/AdminUpdateViewConfiguration.ts new file mode 100644 index 0000000000..8928816dba --- /dev/null +++ b/www/utils/generated/oas-output/schemas/AdminUpdateViewConfiguration.ts @@ -0,0 +1,64 @@ +/** + * @schema AdminUpdateViewConfiguration + * type: object + * description: The details to update in a view configuration. + * x-schemaName: AdminUpdateViewConfiguration + * properties: + * set_active: + * type: boolean + * title: set_active + * description: Whether the view is set as active. + * name: + * type: string + * title: name + * description: The view's name. + * is_system_default: + * type: boolean + * title: is_system_default + * description: Whether the view is the system default. + * configuration: + * type: object + * description: The view's configuration. + * properties: + * search: + * type: string + * title: search + * description: The search query used in the view. + * visible_columns: + * type: array + * description: The configuration's visible columns. + * items: + * type: string + * title: visible_columns + * description: The visible column's name. + * column_order: + * type: array + * description: The columns in the order they should be displayed. + * items: + * type: string + * title: column_order + * description: The column's name. + * column_widths: + * type: object + * description: The column widths in the view. + * filters: + * type: object + * description: The filters applied to the view. + * sorting: + * type: object + * description: The sorting applied to the view. + * required: + * - id + * - desc + * properties: + * id: + * type: string + * title: id + * description: The ID of the sorting column. + * desc: + * type: boolean + * title: desc + * description: Whether the sorting is descending. + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/AdminViewConfiguration.ts b/www/utils/generated/oas-output/schemas/AdminViewConfiguration.ts new file mode 100644 index 0000000000..88976ecca2 --- /dev/null +++ b/www/utils/generated/oas-output/schemas/AdminViewConfiguration.ts @@ -0,0 +1,93 @@ +/** + * @schema AdminViewConfiguration + * type: object + * description: The details of a view configuration. + * x-schemaName: AdminViewConfiguration + * required: + * - id + * - entity + * - name + * - user_id + * - is_system_default + * - created_at + * - updated_at + * properties: + * id: + * type: string + * title: id + * description: The view configuration's ID. + * entity: + * type: string + * title: entity + * description: The entity the view configuration belongs to. + * name: + * type: string + * title: name + * description: The view configuration's name. + * user_id: + * type: string + * title: user_id + * description: The ID of the user the view configuration belongs to. If `null`, the view configuration is a system default. + * is_system_default: + * type: boolean + * title: is_system_default + * description: Whether the view configuration is the system default. + * configuration: + * type: object + * description: The view's configuration. + * required: + * - visible_columns + * - column_order + * properties: + * visible_columns: + * type: array + * description: The configuration's visible columns. + * items: + * type: string + * title: visible_columns + * description: The visible column's name. + * column_order: + * type: array + * description: The columns in the order they should be displayed. + * items: + * type: string + * title: column_order + * description: The column's name. + * column_widths: + * type: object + * description: The column widths in the view. + * filters: + * type: object + * description: The filters applied to the view. + * sorting: + * type: object + * description: The sorting applied to the view. + * required: + * - id + * - desc + * properties: + * id: + * type: string + * title: id + * description: The ID of the sorting column. + * desc: + * type: boolean + * title: desc + * description: Whether the sorting is descending. + * search: + * type: string + * title: search + * description: The configuration's search. + * created_at: + * type: string + * format: date-time + * title: created_at + * description: The date the view configuration was created. + * updated_at: + * type: string + * format: date-time + * title: updated_at + * description: The date the view configuration was updated. + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/AdminViewConfigurationResponse.ts b/www/utils/generated/oas-output/schemas/AdminViewConfigurationResponse.ts new file mode 100644 index 0000000000..eba478bd81 --- /dev/null +++ b/www/utils/generated/oas-output/schemas/AdminViewConfigurationResponse.ts @@ -0,0 +1,13 @@ +/** + * @schema AdminViewConfigurationResponse + * type: object + * description: The details of a view configuration. + * x-schemaName: AdminViewConfigurationResponse + * required: + * - view_configuration + * properties: + * view_configuration: + * $ref: "#/components/schemas/AdminViewConfiguration" + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/AdminViewsEntityColumnsResponse.ts b/www/utils/generated/oas-output/schemas/AdminViewsEntityColumnsResponse.ts new file mode 100644 index 0000000000..b20e36d5e8 --- /dev/null +++ b/www/utils/generated/oas-output/schemas/AdminViewsEntityColumnsResponse.ts @@ -0,0 +1,16 @@ +/** + * @schema AdminViewsEntityColumnsResponse + * type: object + * description: The view's columns. + * x-schemaName: AdminViewsEntityColumnsResponse + * required: + * - columns + * properties: + * columns: + * type: array + * description: The view's columns. + * items: + * $ref: "#/components/schemas/AdminColumn" + * +*/ + diff --git a/www/utils/generated/oas-output/schemas/StoreAddCartLineItem.ts b/www/utils/generated/oas-output/schemas/StoreAddCartLineItem.ts deleted file mode 100644 index c094b6d526..0000000000 --- a/www/utils/generated/oas-output/schemas/StoreAddCartLineItem.ts +++ /dev/null @@ -1,26 +0,0 @@ -/** - * @schema StoreAddCartLineItem - * type: object - * description: The details of the line item to add. - * x-schemaName: StoreAddCartLineItem - * required: - * - variant_id - * - quantity - * properties: - * variant_id: - * type: string - * title: variant_id - * description: The ID of the product variant to add to the cart. - * quantity: - * type: number - * title: quantity - * description: The item's quantity. - * metadata: - * type: object - * description: The item's metadata, can hold custom key-value pairs. - * externalDocs: - * url: https://docs.medusajs.com/api/store#manage-metadata - * description: Learn how to manage metadata - * -*/ - diff --git a/www/utils/generated/oas-output/schemas/StoreAddCartShippingMethods.ts b/www/utils/generated/oas-output/schemas/StoreAddCartShippingMethods.ts deleted file mode 100644 index 9fbd27b533..0000000000 --- a/www/utils/generated/oas-output/schemas/StoreAddCartShippingMethods.ts +++ /dev/null @@ -1,21 +0,0 @@ -/** - * @schema StoreAddCartShippingMethods - * type: object - * description: The shipping method's details. - * required: - * - option_id - * properties: - * option_id: - * type: string - * title: option_id - * description: The ID of the shipping option this method is created from. - * data: - * type: object - * description: Any additional data relevant for the third-party fulfillment provider to process the shipment. - * externalDocs: - * url: https://docs.medusajs.com/v2/resources/storefront-development/checkout/shipping#data-request-body-parameter - * description: Learn more about the data parameter. - * x-schemaName: StoreAddCartShippingMethods - * -*/ - diff --git a/www/utils/generated/oas-output/schemas/StoreCartLineItem.ts b/www/utils/generated/oas-output/schemas/StoreCartLineItem.ts index 1f7462981f..d6ae77e45e 100644 --- a/www/utils/generated/oas-output/schemas/StoreCartLineItem.ts +++ b/www/utils/generated/oas-output/schemas/StoreCartLineItem.ts @@ -289,47 +289,58 @@ * original_total: * type: number * title: original_total - * description: The item's total including taxes, excluding promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. + * description: The item's total including taxes, excluding promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. * original_subtotal: * type: number * title: original_subtotal - * description: The item's total excluding taxes, including promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. + * description: The item's total excluding taxes, including promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. * original_tax_total: * type: number * title: original_tax_total - * description: The total taxes of the item excluding promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. + * description: The total taxes of the item excluding promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. * item_total: * type: number * title: original_tax_total - * description: The item's total including taxes and promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. + * description: The item's total including taxes and promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. * item_subtotal: * type: number * title: item_subtotal - * description: The item's total excluding taxes, including promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. + * description: The item's total excluding taxes, including promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. * item_tax_total: * type: number * title: item_tax_total - * description: The total taxes of the item including promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. + * description: The total taxes of the item including promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. * total: * type: number * title: total - * description: The item's total including taxes and promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. + * description: The item's total including taxes and promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. * subtotal: * type: number * title: subtotal - * description: The item's total excluding taxes, including promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. + * description: The item's total excluding taxes, including promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. * tax_total: * type: number * title: tax_total - * description: The total taxes of the item including promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. + * description: The total taxes of the item including promotions. This field is only available if you expand the `items.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. * discount_total: * type: number * title: discount_total - * description: The total discount of the item. This field is only available if you expand the `items.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. + * description: The total discount of the item. This field is only available if you expand the `items.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. * discount_tax_total: * type: number * title: discount_tax_total - * description: The total taxes applied on the discounted amount. This field is only available if you expand the `items.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. + * description: The total taxes applied on the discounted amount. This field is only available if you expand the `items.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-cart-item-totals) guide. * */ diff --git a/www/utils/generated/oas-output/schemas/StoreCartShippingMethod.ts b/www/utils/generated/oas-output/schemas/StoreCartShippingMethod.ts index ae5e3629f2..b206e613bd 100644 --- a/www/utils/generated/oas-output/schemas/StoreCartShippingMethod.ts +++ b/www/utils/generated/oas-output/schemas/StoreCartShippingMethod.ts @@ -212,35 +212,43 @@ * original_total: * type: number * title: original_total - * description: The shipping method's total including taxes, excluding promotions. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. + * description: The shipping method's total including taxes, excluding promotions. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. * original_subtotal: * type: number * title: original_subtotal - * description: The shipping method's total excluding taxes, including promotions. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. + * description: The shipping method's total excluding taxes, including promotions. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. * original_tax_total: * type: number * title: original_tax_total - * description: The total taxes applied on the shipping method's amount including promotions. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. + * description: The total taxes applied on the shipping method's amount including promotions. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. * total: * type: number * title: total - * description: The shipping method's total amount including taxes and promotions. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. + * description: The shipping method's total amount including taxes and promotions. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. * subtotal: * type: number * title: subtotal - * description: The shipping method's total amount excluding taxes, including promotions. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. + * description: The shipping method's total amount excluding taxes, including promotions. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. * tax_total: * type: number * title: tax_total - * description: The total taxes applied on the shipping method's amount including promotions. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. + * description: The total taxes applied on the shipping method's amount including promotions. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. * discount_total: * type: number * title: discount_total - * description: The total amount discounted. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. + * description: The total amount discounted. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. * discount_tax_total: * type: number * title: discount_tax_total - * description: The taxes applied on the discounted amount. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. + * description: The taxes applied on the discounted amount. This field is only available if you expand the `shipping_methods.*` relation. Learn more in the [Cart + * Totals](https://docs.medusajs.com/resources/storefront-development/cart/totals#retrieve-and-show-shipping-method-totals) guide. * */ diff --git a/www/utils/generated/oas-output/schemas/StoreUpdateCartLineItem.ts b/www/utils/generated/oas-output/schemas/StoreUpdateCartLineItem.ts deleted file mode 100644 index 6b92b74a74..0000000000 --- a/www/utils/generated/oas-output/schemas/StoreUpdateCartLineItem.ts +++ /dev/null @@ -1,21 +0,0 @@ -/** - * @schema StoreUpdateCartLineItem - * type: object - * description: The details to update in the line item. - * x-schemaName: StoreUpdateCartLineItem - * required: - * - quantity - * properties: - * quantity: - * type: number - * title: quantity - * description: The item's quantity. - * metadata: - * type: object - * description: The item's metadata, can hold custom key-value pairs. - * externalDocs: - * url: https://docs.medusajs.com/api/store#manage-metadata - * description: Learn how to manage metadata - * -*/ -