@mercurjs/docs 2.2.0-canary.40

package/content/references/api/admin/order-groups/retrieve-order-group.mdx

@@ -0,0 +1,56 @@
+---
+title: "Retrieve Order Group"
+api: "GET /admin/order-groups/{id}"
+description: "Retrieve an order group by ID."
+---
+
+Returns a single order group.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The order group's ID.</ParamField>
+
+## Query parameters
+
+<ParamField query="fields" type="string">Comma-separated fields to include in the response.</ParamField>
+
+## Response
+
+<ResponseField name="order_group" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The order group's ID.</ResponseField>
+    <ResponseField name="customer_id" type="string">ID of the customer who placed the order.</ResponseField>
+    <ResponseField name="seller_count" type="number">Number of sellers in the group.</ResponseField>
+    <ResponseField name="total" type="number">The group's total amount.</ResponseField>
+    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl 'http://localhost:9000/admin/order-groups/og_01HXYZ8Q2M4N6P8R0T2V4W6X8Y' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { order_group } = await client.admin.orderGroups.$id.query({
+  $id: "og_01HXYZ8Q2M4N6P8R0T2V4W6X8Y",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "order_group": {
+    "id": "og_01HXYZ8Q2M4N6P8R0T2V4W6X8Y",
+    "customer_id": "cus_01HXYZ",
+    "seller_count": 2,
+    "total": 7400,
+    "created_at": "2026-06-01T10:00:00.000Z",
+    "updated_at": "2026-06-01T10:00:00.000Z"
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin/orders/get-order-commission-lines.mdx

@@ -0,0 +1,65 @@
+---
+title: "Get Order Commission Lines"
+api: "GET /admin/orders/{id}/commission-lines"
+description: "Retrieve the commission lines calculated for an order."
+---
+
+Returns the commission lines applied to an order's items and shipping methods.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The order's ID.</ParamField>
+
+## Response
+
+<ResponseField name="commission_lines" type="object[]">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The commission line's ID.</ResponseField>
+    <ResponseField name="item_id" type="string | null">ID of the order item the line applies to.</ResponseField>
+    <ResponseField name="shipping_method_id" type="string | null">ID of the shipping method the line applies to.</ResponseField>
+    <ResponseField name="commission_rate_id" type="string | null">ID of the commission rate that produced the line.</ResponseField>
+    <ResponseField name="code" type="string">Code of the applied commission rate.</ResponseField>
+    <ResponseField name="rate" type="number">The applied commission rate value.</ResponseField>
+    <ResponseField name="amount" type="number">The calculated commission amount.</ResponseField>
+    <ResponseField name="description" type="string | null">Optional description of the line.</ResponseField>
+    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+<ResponseField name="count" type="number">Number of commission lines on the order.</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl 'http://localhost:9000/admin/orders/order_01HXYZ8Q2M4N6P8R0T2V4W6X8Y/commission-lines' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { commission_lines, count } =
+  await client.admin.orders.$id.commissionLines.query({
+    $id: "order_01HXYZ8Q2M4N6P8R0T2V4W6X8Y",
+  })
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "commission_lines": [
+    {
+      "id": "comline_01HXYZ8Q2M4N6P8R0T2V4W6X8Y",
+      "item_id": "ordli_01HXYZ",
+      "shipping_method_id": null,
+      "commission_rate_id": "comrate_01HXYZ",
+      "code": "default",
+      "rate": 10,
+      "amount": 490,
+      "description": null,
+      "created_at": "2026-06-01T10:00:00.000Z",
+      "updated_at": "2026-06-01T10:00:00.000Z"
+    }
+  ],
+  "count": 1
+}
+```
+</ResponseExample>

package/content/references/api/admin/orders/get-order-order-group.mdx

@@ -0,0 +1,56 @@
+---
+title: "Get Order's Order Group"
+api: "GET /admin/orders/{id}/order-group"
+description: "Retrieve the order group a specific order belongs to."
+---
+
+Looks up the order group containing the given order and returns its details. Responds with `404` if the order is not part of any group.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The order's ID.</ParamField>
+
+## Query parameters
+
+<ParamField query="fields" type="string">Comma-separated fields to include in the response.</ParamField>
+
+## Response
+
+<ResponseField name="order_group" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The order group's ID.</ResponseField>
+    <ResponseField name="customer_id" type="string">ID of the customer who placed the order.</ResponseField>
+    <ResponseField name="seller_count" type="number">Number of sellers in the group.</ResponseField>
+    <ResponseField name="total" type="number">The group's total amount.</ResponseField>
+    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl 'http://localhost:9000/admin/orders/order_01HXYZ8Q2M4N6P8R0T2V4W6X8Y/order-group' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { order_group } = await client.admin.orders.$id.orderGroup.query({
+  $id: "order_01HXYZ8Q2M4N6P8R0T2V4W6X8Y",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "order_group": {
+    "id": "og_01HXYZ8Q2M4N6P8R0T2V4W6X8Y",
+    "customer_id": "cus_01HXYZ",
+    "seller_count": 2,
+    "total": 7400,
+    "created_at": "2026-06-01T10:00:00.000Z",
+    "updated_at": "2026-06-01T10:00:00.000Z"
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin/orders/list-orders.mdx

@@ -0,0 +1,79 @@
+---
+title: "List Orders"
+api: "GET /admin/orders"
+description: "Retrieve a paginated list of orders across all sellers."
+---
+
+Returns orders platform-wide. Mercur extends the standard Medusa endpoint with `seller_id` and `name` filters.
+
+## Query parameters
+
+<ParamField query="limit" type="number" default="15">Maximum number of records to return.</ParamField>
+<ParamField query="offset" type="number" default="0">Number of records to skip.</ParamField>
+<ParamField query="order" type="string">Field to sort by, prefix with `-` for descending order.</ParamField>
+<ParamField query="fields" type="string">Comma-separated fields to include in the response.</ParamField>
+<ParamField query="q" type="string">Search term matched against orders.</ParamField>
+<ParamField query="id" type="string | string[]">Filter by order ID(s).</ParamField>
+<ParamField query="status" type="string | string[]">Filter by order status.</ParamField>
+<ParamField query="seller_id" type="string | string[]">Filter to orders belonging to the given seller(s).</ParamField>
+<ParamField query="name" type="string | string[]">Filter by order name(s).</ParamField>
+<ParamField query="sales_channel_id" type="string[]">Filter by sales channel IDs.</ParamField>
+<ParamField query="region_id" type="string | string[]">Filter by region ID(s).</ParamField>
+<ParamField query="customer_id" type="string | string[]">Filter by customer ID(s).</ParamField>
+<ParamField query="total" type="object">Filter by order total using operators like `$gte` and `$lte`.</ParamField>
+<ParamField query="created_at" type="object">Filter by creation date using operators like `$gte` and `$lte`.</ParamField>
+<ParamField query="updated_at" type="object">Filter by update date using operators like `$gte` and `$lte`.</ParamField>
+
+## Response
+
+<ResponseField name="orders" type="object[]">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The order's ID.</ResponseField>
+    <ResponseField name="display_id" type="number">Human-readable order number.</ResponseField>
+    <ResponseField name="status" type="string">The order's status.</ResponseField>
+    <ResponseField name="currency_code" type="string">The order's currency.</ResponseField>
+    <ResponseField name="total" type="number">The order's total amount.</ResponseField>
+    <ResponseField name="customer_id" type="string">ID of the customer who placed the order.</ResponseField>
+    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+<ResponseField name="count" type="number">Total number of matching orders.</ResponseField>
+<ResponseField name="offset" type="number">Number of records skipped.</ResponseField>
+<ResponseField name="limit" type="number">Maximum number of records returned.</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl 'http://localhost:9000/admin/orders?seller_id=sel_01HXYZ&limit=20' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { orders, count } = await client.admin.orders.query({
+  seller_id: "sel_01HXYZ",
+  limit: 20,
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "orders": [
+    {
+      "id": "order_01HXYZ8Q2M4N6P8R0T2V4W6X8Y",
+      "display_id": 128,
+      "status": "pending",
+      "currency_code": "usd",
+      "total": 4900,
+      "customer_id": "cus_01HXYZ",
+      "created_at": "2026-06-01T10:00:00.000Z",
+      "updated_at": "2026-06-01T10:00:00.000Z"
+    }
+  ],
+  "count": 1,
+  "offset": 0,
+  "limit": 20
+}
+```
+</ResponseExample>

package/content/references/api/admin/payouts/list-payouts.mdx

@@ -0,0 +1,75 @@
+---
+title: "List Payouts"
+api: "GET /admin/payouts"
+description: "Retrieve a paginated list of payouts across all sellers."
+---
+
+Returns payouts with their payout account and seller details.
+
+## Query parameters
+
+<ParamField query="limit" type="number" default="50">Maximum number of records to return.</ParamField>
+<ParamField query="offset" type="number" default="0">Number of records to skip.</ParamField>
+<ParamField query="order" type="string">Field to sort by, prefix with `-` for descending order.</ParamField>
+<ParamField query="fields" type="string">Comma-separated fields to include in the response.</ParamField>
+<ParamField query="id" type="string | string[]">Filter by payout ID(s).</ParamField>
+<ParamField query="status" type="string | string[]">Filter by payout status.</ParamField>
+<ParamField query="account_id" type="string | string[]">Filter by payout account ID(s).</ParamField>
+<ParamField query="created_at" type="object">Filter by creation date using operators like `$gte` and `$lte`.</ParamField>
+<ParamField query="updated_at" type="object">Filter by update date using operators like `$gte` and `$lte`.</ParamField>
+
+## Response
+
+<ResponseField name="payouts" type="object[]">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The payout's ID.</ResponseField>
+    <ResponseField name="display_id" type="number">Human-readable payout number.</ResponseField>
+    <ResponseField name="amount" type="number">The payout amount.</ResponseField>
+    <ResponseField name="currency_code" type="string">The payout currency.</ResponseField>
+    <ResponseField name="status" type="string">The payout status.</ResponseField>
+    <ResponseField name="data" type="object | null">Provider-specific payout data.</ResponseField>
+    <ResponseField name="account" type="object">The payout account, with `id` and `status`.</ResponseField>
+    <ResponseField name="seller" type="object">The seller, with `id`, `name`, and `handle`.</ResponseField>
+    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+<ResponseField name="count" type="number">Total number of matching payouts.</ResponseField>
+<ResponseField name="offset" type="number">Number of records skipped.</ResponseField>
+<ResponseField name="limit" type="number">Maximum number of records returned.</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl 'http://localhost:9000/admin/payouts?status=completed&limit=20' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { payouts, count } = await client.admin.payouts.query({
+  status: "completed",
+  limit: 20,
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "payouts": [
+    {
+      "id": "pout_01HXYZ8Q2M4N6P8R0T2V4W6X8Y",
+      "display_id": 42,
+      "amount": 1250,
+      "currency_code": "usd",
+      "status": "completed",
+      "data": null,
+      "account": { "id": "pacc_01HXYZ", "status": "active" },
+      "seller": { "id": "sel_01HXYZ", "name": "Acme Store", "handle": "acme-store" }
+    }
+  ],
+  "count": 1,
+  "offset": 0,
+  "limit": 20
+}
+```
+</ResponseExample>

package/content/references/api/admin/payouts/retrieve-payout.mdx

@@ -0,0 +1,62 @@
+---
+title: "Retrieve Payout"
+api: "GET /admin/payouts/{id}"
+description: "Retrieve a payout by ID."
+---
+
+Returns a single payout with its payout account and seller details.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The payout's ID.</ParamField>
+
+## Query parameters
+
+<ParamField query="fields" type="string">Comma-separated fields to include in the response.</ParamField>
+
+## Response
+
+<ResponseField name="payout" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The payout's ID.</ResponseField>
+    <ResponseField name="display_id" type="number">Human-readable payout number.</ResponseField>
+    <ResponseField name="amount" type="number">The payout amount.</ResponseField>
+    <ResponseField name="currency_code" type="string">The payout currency.</ResponseField>
+    <ResponseField name="status" type="string">The payout status.</ResponseField>
+    <ResponseField name="data" type="object | null">Provider-specific payout data.</ResponseField>
+    <ResponseField name="account" type="object">The payout account, with `id` and `status`.</ResponseField>
+    <ResponseField name="seller" type="object">The seller, with `id`, `name`, and `handle`.</ResponseField>
+    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl 'http://localhost:9000/admin/payouts/pout_01HXYZ8Q2M4N6P8R0T2V4W6X8Y' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { payout } = await client.admin.payouts.$id.query({
+  $id: "pout_01HXYZ8Q2M4N6P8R0T2V4W6X8Y",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "payout": {
+    "id": "pout_01HXYZ8Q2M4N6P8R0T2V4W6X8Y",
+    "display_id": 42,
+    "amount": 1250,
+    "currency_code": "usd",
+    "status": "completed",
+    "data": null,
+    "account": { "id": "pacc_01HXYZ", "status": "active" },
+    "seller": { "id": "sel_01HXYZ", "name": "Acme Store", "handle": "acme-store" }
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin/product-attributes/create-attribute-value.mdx

@@ -0,0 +1,76 @@
+---
+title: "Upsert Attribute Values"
+api: "POST /admin/product-attributes/{id}/values"
+description: "Create or update values on a product attribute."
+---
+
+Upserts the given values on the attribute — items with an `id` update an existing value, items without one create a new value.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The attribute's ID.</ParamField>
+
+## Body parameters
+
+<ParamField body="values" type="object[]" required>
+  Values to create or update — one of two shapes per item.
+  <Expandable title="update existing value (by id)">
+    <ParamField body="id" type="string" required>The value's ID.</ParamField>
+    <ParamField body="name" type="string">Value name.</ParamField>
+    <ParamField body="handle" type="string">Unique URL-safe handle.</ParamField>
+    <ParamField body="rank" type="number">Sort rank; must be non-negative.</ParamField>
+    <ParamField body="is_active" type="boolean">Whether the value is active.</ParamField>
+    <ParamField body="metadata" type="object">Custom key-value data.</ParamField>
+  </Expandable>
+  <Expandable title="create new value (by name)">
+    <ParamField body="name" type="string" required>Value name.</ParamField>
+    <ParamField body="handle" type="string">Unique URL-safe handle.</ParamField>
+    <ParamField body="rank" type="number">Sort rank; must be non-negative.</ParamField>
+    <ParamField body="is_active" type="boolean">Whether the value is active.</ParamField>
+    <ParamField body="metadata" type="object">Custom key-value data.</ParamField>
+  </Expandable>
+</ParamField>
+
+## Response
+
+<ResponseField name="product_attribute" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The attribute's ID.</ResponseField>
+    <ResponseField name="name" type="string">Attribute name.</ResponseField>
+    <ResponseField name="type" type="string">The attribute's type.</ResponseField>
+    <ResponseField name="values" type="object[]">All values after the upsert, with `id`, `name`, `handle`, `rank`, and `is_active`.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/admin/product-attributes/pattr_01HXYZABCDEF/values' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'Content-Type: application/json' \
+  -d '{"values": [{ "name": "Wool" }, { "id": "pattrval_01HXYZABCDEF", "rank": 1 }]}'
+```
+
+```ts JS Client
+const { product_attribute } = await client.admin.productAttributes.$id.values.mutate({
+  $id: "pattr_01HXYZABCDEF",
+  values: [{ name: "Wool" }, { id: "pattrval_01HXYZABCDEF", rank: 1 }],
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "product_attribute": {
+    "id": "pattr_01HXYZABCDEF",
+    "name": "Material",
+    "type": "single_select",
+    "values": [
+      { "id": "pattrval_01HXYZABCDEG", "name": "Wool", "rank": 0 },
+      { "id": "pattrval_01HXYZABCDEF", "name": "Linen", "rank": 1 }
+    ]
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin/product-attributes/create-product-attribute.mdx

@@ -0,0 +1,99 @@
+---
+title: "Create Product Attribute"
+api: "POST /admin/product-attributes"
+description: "Create a catalog product attribute."
+---
+
+Creates a shared attribute that products across the catalog can use.
+
+<Note>
+`is_variant_axis` is only valid for `multi_select` attributes — axis attributes provide the value sets that variants are generated from.
+</Note>
+
+## Body parameters
+
+<ParamField body="name" type="string" required>Attribute name.</ParamField>
+<ParamField body="type" type="string" required>One of `single_select`, `multi_select`, `unit`, `toggle`, `text`.</ParamField>
+<ParamField body="handle" type="string">Unique URL-safe handle, generated from the name if omitted.</ParamField>
+<ParamField body="description" type="string">Attribute description.</ParamField>
+<ParamField body="is_required" type="boolean">Whether a value is required on products.</ParamField>
+<ParamField body="is_filterable" type="boolean">Whether the attribute can be used as a storefront filter.</ParamField>
+<ParamField body="is_variant_axis" type="boolean">Whether the attribute drives variant generation; only valid for `multi_select`.</ParamField>
+<ParamField body="rank" type="number">Sort rank of the attribute; must be non-negative.</ParamField>
+<ParamField body="is_active" type="boolean">Whether the attribute is active.</ParamField>
+<ParamField body="category_ids" type="string[]">IDs of categories to link the attribute to; omit for a global attribute.</ParamField>
+<ParamField body="values" type="object[]">
+  Initial attribute values for select types.
+  <Expandable title="properties">
+    <ParamField body="name" type="string" required>Value name.</ParamField>
+    <ParamField body="handle" type="string">Unique URL-safe handle.</ParamField>
+    <ParamField body="rank" type="number">Sort rank; must be non-negative.</ParamField>
+    <ParamField body="is_active" type="boolean">Whether the value is active.</ParamField>
+    <ParamField body="metadata" type="object">Custom key-value data.</ParamField>
+  </Expandable>
+</ParamField>
+<ParamField body="metadata" type="object">Custom key-value data.</ParamField>
+<ParamField body="additional_data" type="object">Custom data passed to workflow hooks.</ParamField>
+
+## Response
+
+<ResponseField name="product_attribute" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The attribute's ID.</ResponseField>
+    <ResponseField name="name" type="string">Attribute name.</ResponseField>
+    <ResponseField name="handle" type="string">Unique URL-safe handle.</ResponseField>
+    <ResponseField name="type" type="string">One of `single_select`, `multi_select`, `unit`, `toggle`, `text`.</ResponseField>
+    <ResponseField name="is_required" type="boolean">Whether a value is required on products.</ResponseField>
+    <ResponseField name="is_filterable" type="boolean">Whether the attribute can be used as a storefront filter.</ResponseField>
+    <ResponseField name="is_variant_axis" type="boolean">Whether the attribute drives variant generation.</ResponseField>
+    <ResponseField name="is_active" type="boolean">Whether the attribute is active.</ResponseField>
+    <ResponseField name="values" type="object[]">The attribute's values.</ResponseField>
+    <ResponseField name="categories" type="object[]">Linked categories with `id`, `name`, and `handle`.</ResponseField>
+    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/admin/product-attributes' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "name": "Material",
+    "type": "single_select",
+    "is_filterable": true,
+    "values": [{ "name": "Linen" }, { "name": "Cotton" }]
+  }'
+```
+
+```ts JS Client
+const { product_attribute } = await client.admin.productAttributes.mutate({
+  name: "Material",
+  type: "single_select",
+  is_filterable: true,
+  values: [{ name: "Linen" }, { name: "Cotton" }],
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "product_attribute": {
+    "id": "pattr_01HXYZABCDEF",
+    "name": "Material",
+    "handle": "material",
+    "type": "single_select",
+    "is_required": false,
+    "is_filterable": true,
+    "is_variant_axis": false,
+    "is_active": true,
+    "values": [
+      { "id": "pattrval_01HXYZABCDEF", "name": "Linen", "rank": 0 },
+      { "id": "pattrval_01HXYZABCDEG", "name": "Cotton", "rank": 1 }
+    ]
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin/product-attributes/delete-attribute-value.mdx

@@ -0,0 +1,52 @@
+---
+title: "Delete Attribute Value"
+api: "DELETE /admin/product-attributes/{id}/values/{value_id}"
+description: "Delete a value from a product attribute."
+---
+
+Deletes the value and returns the parent attribute.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The attribute's ID.</ParamField>
+<ParamField path="value_id" type="string" required>The value's ID.</ParamField>
+
+## Response
+
+<ResponseField name="product_attribute" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The attribute's ID.</ResponseField>
+    <ResponseField name="name" type="string">Attribute name.</ResponseField>
+    <ResponseField name="type" type="string">The attribute's type.</ResponseField>
+    <ResponseField name="values" type="object[]">Remaining values after deletion.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X DELETE 'http://localhost:9000/admin/product-attributes/pattr_01HXYZABCDEF/values/pattrval_01HXYZABCDEF' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { product_attribute } =
+  await client.admin.productAttributes.$id.values.$value_id.delete({
+    $id: "pattr_01HXYZABCDEF",
+    $value_id: "pattrval_01HXYZABCDEF",
+  })
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "product_attribute": {
+    "id": "pattr_01HXYZABCDEF",
+    "name": "Material",
+    "type": "single_select",
+    "values": []
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin/product-attributes/delete-product-attribute.mdx

@@ -0,0 +1,40 @@
+---
+title: "Delete Product Attribute"
+api: "DELETE /admin/product-attributes/{id}"
+description: "Delete a catalog product attribute."
+---
+
+Deletes the attribute and its values.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The attribute's ID.</ParamField>
+
+## Response
+
+<ResponseField name="id" type="string">The deleted attribute's ID.</ResponseField>
+<ResponseField name="object" type="string">Always `product_attribute`.</ResponseField>
+<ResponseField name="deleted" type="boolean">Always `true`.</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X DELETE 'http://localhost:9000/admin/product-attributes/pattr_01HXYZABCDEF' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const result = await client.admin.productAttributes.$id.delete({
+  $id: "pattr_01HXYZABCDEF",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "id": "pattr_01HXYZABCDEF",
+  "object": "product_attribute",
+  "deleted": true
+}
+```
+</ResponseExample>