@mercurjs/docs 2.2.0-canary.40

package/content/references/api/admin/product-attributes/list-product-attributes.mdx

@@ -0,0 +1,91 @@
+---
+title: "List Product Attributes"
+api: "GET /admin/product-attributes"
+description: "Retrieve a paginated list of catalog product attributes."
+---
+
+Returns global (non-product-scoped) attributes, with optional filtering by type, flags, and category.
+
+## 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 list of fields to include, prefix with `+`/`-` to add or remove from defaults.</ParamField>
+<ParamField query="q" type="string">Search term matched against attribute fields.</ParamField>
+<ParamField query="id" type="string | string[]">Filter by attribute ID(s).</ParamField>
+<ParamField query="handle" type="string | string[]">Filter by attribute handle(s).</ParamField>
+<ParamField query="type" type="string | string[]">Filter by type: `single_select`, `multi_select`, `unit`, `toggle`, or `text`.</ParamField>
+<ParamField query="is_required" type="boolean">Filter by the required flag.</ParamField>
+<ParamField query="is_variant_axis" type="boolean">Filter by the variant-axis flag.</ParamField>
+<ParamField query="is_filterable" type="boolean">Filter by the filterable flag.</ParamField>
+<ParamField query="is_active" type="boolean">Filter by the active flag.</ParamField>
+<ParamField query="category_id" type="string | string[]">Filter to attributes linked to the given category(ies) or global to all categories.</ParamField>
+<ParamField query="created_at" type="object">Filter by creation date with operators like `$gte`, `$lte`.</ParamField>
+<ParamField query="updated_at" type="object">Filter by update date with operators like `$gte`, `$lte`.</ParamField>
+
+## Response
+
+<ResponseField name="product_attributes" 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="description" type="string">Attribute description.</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="created_by" type="string">ID of the actor who created the attribute.</ResponseField>
+    <ResponseField name="product_id" type="string">Always `null` for catalog attributes.</ResponseField>
+    <ResponseField name="rank" type="number">Sort rank of the attribute.</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="metadata" type="object">Custom key-value data.</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 attributes.</ResponseField>
+<ResponseField name="offset" type="number">Number of records skipped.</ResponseField>
+<ResponseField name="limit" type="number">Number of records returned.</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl 'http://localhost:9000/admin/product-attributes?type=single_select&limit=20' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { product_attributes, count } = await client.admin.productAttributes.query({
+  type: "single_select",
+  limit: 20,
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "product_attributes": [
+    {
+      "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 }
+      ]
+    }
+  ],
+  "count": 1,
+  "offset": 0,
+  "limit": 20
+}
+```
+</ResponseExample>

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

@@ -0,0 +1,81 @@
+---
+title: "Retrieve Product Attribute"
+api: "GET /admin/product-attributes/{id}"
+description: "Retrieve a catalog product attribute by ID."
+---
+
+Returns a single attribute with its values and linked categories.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The attribute's ID.</ParamField>
+
+## Query parameters
+
+<ParamField query="fields" type="string">Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.</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="description" type="string">Attribute description.</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="created_by" type="string">ID of the actor who created the attribute.</ResponseField>
+    <ResponseField name="product_id" type="string">Owning product's ID for product-scoped attributes, otherwise `null`.</ResponseField>
+    <ResponseField name="rank" type="number">Sort rank of the attribute.</ResponseField>
+    <ResponseField name="values" type="object[]">
+      The attribute's values.
+      <Expandable title="properties">
+        <ResponseField name="id" type="string">The value's ID.</ResponseField>
+        <ResponseField name="name" type="string">Value name.</ResponseField>
+        <ResponseField name="handle" type="string">Unique URL-safe handle.</ResponseField>
+        <ResponseField name="rank" type="number">Sort rank.</ResponseField>
+        <ResponseField name="is_active" type="boolean">Whether the value is active.</ResponseField>
+      </Expandable>
+    </ResponseField>
+    <ResponseField name="categories" type="object[]">Linked categories with `id`, `name`, and `handle`.</ResponseField>
+    <ResponseField name="metadata" type="object">Custom key-value data.</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/product-attributes/pattr_01HXYZABCDEF' \
+  -H 'Authorization: Bearer <token>'
+```
+
+```ts JS Client
+const { product_attribute } = await client.admin.productAttributes.$id.query({
+  $id: "pattr_01HXYZABCDEF",
+})
+```
+</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 }
+    ]
+  }
+}
+```
+</ResponseExample>

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

@@ -0,0 +1,66 @@
+---
+title: "Update Attribute Value"
+api: "POST /admin/product-attributes/{id}/values/{value_id}"
+description: "Update a single value on a product attribute."
+---
+
+Updates 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>
+
+## Body parameters
+
+<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>
+<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="type" type="string">The attribute's type.</ResponseField>
+    <ResponseField name="values" type="object[]">All values, including the updated one.</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/pattrval_01HXYZABCDEF' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'Content-Type: application/json' \
+  -d '{"name": "Belgian Linen"}'
+```
+
+```ts JS Client
+const { product_attribute } =
+  await client.admin.productAttributes.$id.values.$value_id.mutate({
+    $id: "pattr_01HXYZABCDEF",
+    $value_id: "pattrval_01HXYZABCDEF",
+    name: "Belgian Linen",
+  })
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "product_attribute": {
+    "id": "pattr_01HXYZABCDEF",
+    "name": "Material",
+    "type": "single_select",
+    "values": [
+      { "id": "pattrval_01HXYZABCDEF", "name": "Belgian Linen", "rank": 0 }
+    ]
+  }
+}
+```
+</ResponseExample>

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

@@ -0,0 +1,76 @@
+---
+title: "Update Product Attribute"
+api: "POST /admin/product-attributes/{id}"
+description: "Update a catalog product attribute."
+---
+
+Updates the attribute's details; only the provided fields are changed.
+
+<Note>
+`type` is immutable — sending a `type` different from the attribute's current type returns an error.
+</Note>
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The attribute's ID.</ParamField>
+
+## Body parameters
+
+<ParamField body="name" type="string">Attribute name.</ParamField>
+<ParamField body="handle" type="string">Unique URL-safe handle.</ParamField>
+<ParamField body="description" type="string">Attribute description.</ParamField>
+<ParamField body="type" type="string">Must match the current type: `single_select`, `multi_select`, `unit`, `toggle`, or `text`.</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; replaces the existing links.</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">The attribute's type.</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="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/admin/product-attributes/pattr_01HXYZABCDEF' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'Content-Type: application/json' \
+  -d '{"name": "Fabric", "is_filterable": true}'
+```
+
+```ts JS Client
+const { product_attribute } = await client.admin.productAttributes.$id.mutate({
+  $id: "pattr_01HXYZABCDEF",
+  name: "Fabric",
+  is_filterable: true,
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "product_attribute": {
+    "id": "pattr_01HXYZABCDEF",
+    "name": "Fabric",
+    "handle": "material",
+    "type": "single_select",
+    "is_filterable": true,
+    "updated_at": "2026-06-02T09:00:00.000Z"
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin/product-changes/cancel-product-change.mdx

@@ -0,0 +1,68 @@
+---
+title: "Cancel Product Change"
+api: "POST /admin/product-changes/{id}/cancel"
+description: "Cancel a pending product change without applying it."
+---
+
+Cancels the pending change set and returns the updated change record.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The product change's ID.</ParamField>
+
+## Body parameters
+
+<ParamField body="internal_note" type="string">Note recorded with the cancellation, visible to operators only.</ParamField>
+
+## Response
+
+<ResponseField name="product_change" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The product change's ID.</ResponseField>
+    <ResponseField name="product_id" type="string">ID of the product the change applied to.</ResponseField>
+    <ResponseField name="status" type="string">Change status after cancellation.</ResponseField>
+    <ResponseField name="canceled_by" type="string">ID of the actor who canceled the change.</ResponseField>
+    <ResponseField name="canceled_at" type="string">When the change was canceled.</ResponseField>
+    <ResponseField name="actions" type="object[]">The change's individual actions with `action`, `ordering`, `details`, and `applied`.</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-changes/prodch_01HXYZABCDEF/cancel' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'Content-Type: application/json' \
+  -d '{}'
+```
+
+```ts JS Client
+const { product_change } = await client.admin.productChanges.$id.cancel.mutate({
+  $id: "prodch_01HXYZABCDEF",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "product_change": {
+    "id": "prodch_01HXYZABCDEF",
+    "product_id": "prod_01HXYZABCDEF",
+    "status": "canceled",
+    "canceled_by": "user_01HXYZABCDEF",
+    "canceled_at": "2026-06-02T09:00:00.000Z",
+    "actions": [
+      {
+        "id": "prodchact_01HXYZABCDEF",
+        "action": "update_product",
+        "ordering": 0,
+        "details": { "title": "Linen Shirt v2" },
+        "applied": false
+      }
+    ]
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin/product-changes/confirm-product-change.mdx

@@ -0,0 +1,47 @@
+---
+title: "Confirm Product Change"
+api: "POST /admin/product-changes/{id}/confirm"
+description: "Approve a pending product change and apply it to the product."
+---
+
+Applies the pending change set to the product and marks the change as confirmed.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The product change's ID.</ParamField>
+
+## Body parameters
+
+<ParamField body="internal_note" type="string">Note recorded on the confirmation, visible to operators only.</ParamField>
+
+## Response
+
+<ResponseField name="id" type="string">The confirmed product change's ID.</ResponseField>
+<ResponseField name="object" type="string">Always `product_change`.</ResponseField>
+<ResponseField name="deleted" type="boolean">Always `true` — the change is no longer pending.</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/admin/product-changes/prodch_01HXYZABCDEF/confirm' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'Content-Type: application/json' \
+  -d '{"internal_note": "Approved after review"}'
+```
+
+```ts JS Client
+const result = await client.admin.productChanges.$id.confirm.mutate({
+  $id: "prodch_01HXYZABCDEF",
+  internal_note: "Approved after review",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "id": "prodch_01HXYZABCDEF",
+  "object": "product_change",
+  "deleted": true
+}
+```
+</ResponseExample>

package/content/references/api/admin/products/batch-product-attributes.mdx

@@ -0,0 +1,96 @@
+---
+title: "Batch Product Attributes"
+api: "POST /admin/products/{id}/attributes/batch"
+description: "Add, remove, and update attributes on a product in one request."
+---
+
+Applies attribute changes to the product in the order `remove` → `add` → `update`.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The product's ID.</ParamField>
+
+## Body parameters
+
+<ParamField body="add" type="object[]">
+  Attributes to attach — one of two shapes per item.
+  <Expandable title="existing attribute (by id)">
+    <ParamField body="id" type="string" required>ID of an existing catalog attribute.</ParamField>
+    <ParamField body="value_ids" type="string[]">IDs of attribute values to select.</ParamField>
+    <ParamField body="value" type="string | number | boolean">Scalar value for `text`, `unit`, or `toggle` attributes.</ParamField>
+  </Expandable>
+  <Expandable title="inline attribute (by title)">
+    <ParamField body="title" type="string" required>Attribute title.</ParamField>
+    <ParamField body="type" type="string">One of `single_select`, `multi_select`, `unit`, `toggle`, `text`; required for non-axis inline attributes unless `value` is a boolean.</ParamField>
+    <ParamField body="values" type="string[]">Value names to create and select.</ParamField>
+    <ParamField body="value" type="string | number | boolean">Scalar value for non-select types.</ParamField>
+    <ParamField body="is_variant_axis" type="boolean">Whether the attribute drives variant generation; only allowed on `multi_select` attributes.</ParamField>
+    <ParamField body="is_filterable" type="boolean">Whether the attribute can be used as a storefront filter.</ParamField>
+    <ParamField body="is_required" type="boolean">Whether a value is required on products.</ParamField>
+    <ParamField body="description" type="string">Attribute description.</ParamField>
+    <ParamField body="metadata" type="object">Custom key-value data.</ParamField>
+  </Expandable>
+</ParamField>
+<ParamField body="remove" type="string[]">IDs of attributes to detach from the product.</ParamField>
+<ParamField body="update" type="object[]">
+  Changes to attributes already on the product.
+  <Expandable title="properties">
+    <ParamField body="id" type="string" required>The attribute's ID.</ParamField>
+    <ParamField body="title" type="string">New attribute title.</ParamField>
+    <ParamField body="add" type="(string | object)[]">Value names (or `{ value }` objects) to add to the selection.</ParamField>
+    <ParamField body="remove" type="string[]">Value IDs to remove from the selection.</ParamField>
+    <ParamField body="value" type="string | number | boolean">New scalar value for non-select types.</ParamField>
+  </Expandable>
+</ParamField>
+
+## Response
+
+<ResponseField name="product" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The product's ID.</ResponseField>
+    <ResponseField name="title" type="string">Product title.</ResponseField>
+    <ResponseField name="status" type="string">Current product status.</ResponseField>
+    <ResponseField name="product_attribute_values" type="object[]">Attribute values selected on the product, each with its parent `attribute`.</ResponseField>
+    <ResponseField name="scoped_attributes" type="object[]">Product-scoped (inline) attributes with their `values`.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/admin/products/prod_01HXYZABCDEF/attributes/batch' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "add": [{ "id": "pattr_01HXYZABCDEF", "value_ids": ["pattrval_01HXYZABCDEF"] }],
+    "remove": ["pattr_01HXYZABCDEG"]
+  }'
+```
+
+```ts JS Client
+const { product } = await client.admin.products.$id.attributes.batch.mutate({
+  $id: "prod_01HXYZABCDEF",
+  add: [{ id: "pattr_01HXYZABCDEF", value_ids: ["pattrval_01HXYZABCDEF"] }],
+  remove: ["pattr_01HXYZABCDEG"],
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "product": {
+    "id": "prod_01HXYZABCDEF",
+    "title": "Linen Shirt",
+    "status": "published",
+    "product_attribute_values": [
+      {
+        "id": "pattrval_01HXYZABCDEF",
+        "name": "Linen",
+        "attribute": { "id": "pattr_01HXYZABCDEF", "name": "Material", "type": "single_select" }
+      }
+    ],
+    "scoped_attributes": []
+  }
+}
+```
+</ResponseExample>

package/content/references/api/admin/products/confirm-product.mdx

@@ -0,0 +1,59 @@
+---
+title: "Confirm Product"
+api: "POST /admin/products/{id}/confirm"
+description: "Approve a proposed product for publishing."
+---
+
+Approves the product's publish request and returns the updated product.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>The product's ID.</ParamField>
+
+## Query parameters
+
+<ParamField query="fields" type="string">Comma-separated list of fields to include, prefix with `+`/`-` to add or remove from defaults.</ParamField>
+
+## Body parameters
+
+<ParamField body="internal_note" type="string">Note recorded on the approval, visible to operators only.</ParamField>
+
+## Response
+
+<ResponseField name="product" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The product's ID.</ResponseField>
+    <ResponseField name="title" type="string">Product title.</ResponseField>
+    <ResponseField name="status" type="string">Product status after confirmation.</ResponseField>
+    <ResponseField name="updated_at" type="string">Last update timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/admin/products/prod_01HXYZABCDEF/confirm' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'Content-Type: application/json' \
+  -d '{"internal_note": "Looks good"}'
+```
+
+```ts JS Client
+const { product } = await client.admin.products.$id.confirm.mutate({
+  $id: "prod_01HXYZABCDEF",
+  internal_note: "Looks good",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "product": {
+    "id": "prod_01HXYZABCDEF",
+    "title": "Linen Shirt",
+    "status": "published",
+    "updated_at": "2026-06-02T09:00:00.000Z"
+  }
+}
+```
+</ResponseExample>