@mercurjs/docs 2.2.0-canary.40

package/content/references/api/vendor/products/retrieve-product-variant.mdx

@@ -0,0 +1,76 @@
+---
+title: "Retrieve Product Variant"
+api: "GET /vendor/products/{id}/variants/{variant_id}"
+description: "Retrieve a single variant of a product."
+---
+
+Returns a variant scoped to the given product.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>
+  The product's ID.
+</ParamField>
+
+<ParamField path="variant_id" type="string" required>
+  The variant's ID.
+</ParamField>
+
+## Query parameters
+
+<ParamField query="fields" type="string">
+  Comma-separated fields to include in the response. Prefix with `+`/`-` to add to or remove from the defaults.
+</ParamField>
+
+## Response
+
+<ResponseField name="variant" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The variant's ID.</ResponseField>
+    <ResponseField name="title" type="string">The variant's title.</ResponseField>
+    <ResponseField name="sku" type="string">The variant's SKU.</ResponseField>
+    <ResponseField name="ean" type="string">EAN barcode.</ResponseField>
+    <ResponseField name="upc" type="string">UPC barcode.</ResponseField>
+    <ResponseField name="barcode" type="string">Generic barcode.</ResponseField>
+    <ResponseField name="product_id" type="string">ID of the parent product.</ResponseField>
+    <ResponseField name="manage_inventory" type="boolean">Whether inventory is managed for the variant.</ResponseField>
+    <ResponseField name="allow_backorder" type="boolean">Whether backorders are allowed.</ResponseField>
+    <ResponseField name="variant_rank" type="number">Sort rank of the variant.</ResponseField>
+    <ResponseField name="options" type="object[]">Selected option values with `id`, `value`, and the parent `option`.</ResponseField>
+    <ResponseField name="images" type="object[]">Variant images with `id`, `url`, and `rank`.</ResponseField>
+    <ResponseField name="metadata" type="object">Custom key-value pairs.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl 'http://localhost:9000/vendor/products/prod_01HXYZ/variants/variant_01HXYZ' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'x-seller-id: <seller_id>'
+```
+
+```ts JS Client
+const { variant } = await client.vendor.products.$id.variants.$variant_id.query({
+  $id: "prod_01HXYZ",
+  $variant_id: "variant_01HXYZ",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "variant": {
+    "id": "variant_01HXYZ",
+    "title": "M",
+    "sku": "ACME-SHIRT-M",
+    "product_id": "prod_01HXYZ",
+    "manage_inventory": false,
+    "allow_backorder": false,
+    "options": [
+      { "id": "optval_01HXYZ", "value": "M", "option": { "id": "opt_01HXYZ", "title": "Size" } }
+    ]
+  }
+}
+```
+</ResponseExample>

package/content/references/api/vendor/products/retrieve-product.mdx

@@ -0,0 +1,69 @@
+---
+title: "Retrieve Product"
+api: "GET /vendor/products/{id}"
+description: "Retrieve a product by its ID."
+---
+
+Returns a single product with its images, variants, and attribute assignments.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>
+  The product's ID.
+</ParamField>
+
+## Query parameters
+
+<ParamField query="fields" type="string">
+  Comma-separated fields to include in the response. Prefix with `+`/`-` to add to or remove from the defaults. Include `variants.offers` to attach the seller's offers to each variant.
+</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">The product's title.</ResponseField>
+    <ResponseField name="subtitle" type="string">The product's subtitle.</ResponseField>
+    <ResponseField name="description" type="string">The product's description.</ResponseField>
+    <ResponseField name="status" type="string">One of `draft`, `proposed`, `published`, `rejected`.</ResponseField>
+    <ResponseField name="handle" type="string">The product's URL handle.</ResponseField>
+    <ResponseField name="thumbnail" type="string">URL of the product's thumbnail image.</ResponseField>
+    <ResponseField name="images" type="object[]">Images with `id`, `url`, and `rank`.</ResponseField>
+    <ResponseField name="collection" type="object">The associated collection with `id`, `title`, and `handle`.</ResponseField>
+    <ResponseField name="categories" type="object[]">Associated categories with `id`, `name`, and `handle`.</ResponseField>
+    <ResponseField name="variants" type="object[]">Variants with `id`, `title`, `sku`, `manage_inventory`, `allow_backorder`, and `variant_rank`.</ResponseField>
+    <ResponseField name="attributes" type="object[]">Product attributes grouped per attribute with their selected values.</ResponseField>
+    <ResponseField name="metadata" type="object">Custom key-value pairs.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl 'http://localhost:9000/vendor/products/prod_01HXYZ' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'x-seller-id: <seller_id>'
+```
+
+```ts JS Client
+const { product } = await client.vendor.products.$id.query({
+  $id: "prod_01HXYZ",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "product": {
+    "id": "prod_01HXYZ",
+    "title": "Acme T-Shirt",
+    "status": "published",
+    "handle": "acme-t-shirt",
+    "variants": [
+      { "id": "variant_01HXYZ", "title": "M", "sku": "ACME-SHIRT-M" }
+    ]
+  }
+}
+```
+</ResponseExample>

package/content/references/api/vendor/products/update-product-variant.mdx

@@ -0,0 +1,104 @@
+---
+title: "Update Product Variant"
+api: "POST /vendor/products/{id}/variants/{variant_id}"
+description: "Stage an update to a product variant as a change request."
+---
+
+Stages a `VARIANT_UPDATE` operation as a pending change request instead of updating the variant directly.
+
+<Note>
+  The endpoint responds with `202 Accepted` and a `product_change` record, not the updated variant.
+</Note>
+
+## Path parameters
+
+<ParamField path="id" type="string" required>
+  The product's ID.
+</ParamField>
+
+<ParamField path="variant_id" type="string" required>
+  The variant's ID.
+</ParamField>
+
+## Body parameters
+
+<ParamField body="title" type="string">The variant's title.</ParamField>
+<ParamField body="sku" type="string">The variant's SKU.</ParamField>
+<ParamField body="ean" type="string">EAN barcode.</ParamField>
+<ParamField body="upc" type="string">UPC barcode.</ParamField>
+<ParamField body="isbn" type="string">ISBN code.</ParamField>
+<ParamField body="asin" type="string">Amazon ASIN.</ParamField>
+<ParamField body="gtin" type="string">GTIN code.</ParamField>
+<ParamField body="barcode" type="string">Generic barcode.</ParamField>
+<ParamField body="hs_code" type="string">Harmonized System code.</ParamField>
+<ParamField body="mid_code" type="string">Manufacturer ID code.</ParamField>
+<ParamField body="thumbnail" type="string">Variant thumbnail URL.</ParamField>
+<ParamField body="variant_rank" type="number">Sort rank of the variant.</ParamField>
+<ParamField body="weight" type="number">Weight of the variant.</ParamField>
+<ParamField body="length" type="number">Length of the variant.</ParamField>
+<ParamField body="height" type="number">Height of the variant.</ParamField>
+<ParamField body="width" type="number">Width of the variant.</ParamField>
+<ParamField body="origin_country" type="string">Country of origin.</ParamField>
+<ParamField body="material" type="string">Material of the variant.</ParamField>
+<ParamField body="allow_backorder" type="boolean">Whether backorders are allowed.</ParamField>
+<ParamField body="manage_inventory" type="boolean">Whether inventory is managed for the variant.</ParamField>
+<ParamField body="metadata" type="object">Custom key-value pairs.</ParamField>
+<ParamField body="options" type="object">Option title to value mapping, e.g. `{"Size": "M"}`.</ParamField>
+
+<ParamField body="images" type="object">
+  <Expandable title="properties">
+    <ParamField body="add" type="string[]">Image URLs to attach to the variant.</ParamField>
+    <ParamField body="remove" type="string[]">Image IDs to detach from the variant.</ParamField>
+  </Expandable>
+</ParamField>
+
+## Response
+
+<ResponseField name="product_change" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The change request's ID.</ResponseField>
+    <ResponseField name="product_id" type="string">ID of the product the change targets.</ResponseField>
+    <ResponseField name="status" type="string">One of `pending`, `confirmed`, `declined`, `canceled`.</ResponseField>
+    <ResponseField name="actions" type="object[]">Staged operations, each with `id`, `action` (`VARIANT_UPDATE`), `details`, `ordering`, and `applied`.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/vendor/products/prod_01HXYZ/variants/variant_01HXYZ' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'x-seller-id: <seller_id>' \
+  -H 'Content-Type: application/json' \
+  -d '{"sku": "ACME-SHIRT-M-V2", "weight": 200}'
+```
+
+```ts JS Client
+const { product_change } =
+  await client.vendor.products.$id.variants.$variant_id.mutate({
+    $id: "prod_01HXYZ",
+    $variant_id: "variant_01HXYZ",
+    sku: "ACME-SHIRT-M-V2",
+    weight: 200,
+  })
+```
+</RequestExample>
+
+<ResponseExample>
+```json 202
+{
+  "product_change": {
+    "id": "prodch_01HXYZ",
+    "product_id": "prod_01HXYZ",
+    "status": "pending",
+    "actions": [
+      {
+        "id": "prodchact_01HXYZ",
+        "action": "VARIANT_UPDATE",
+        "details": { "variant_id": "variant_01HXYZ", "fields": { "sku": "ACME-SHIRT-M-V2" } },
+        "applied": false
+      }
+    ]
+  }
+}
+```
+</ResponseExample>

package/content/references/api/vendor/products/update-product.mdx

@@ -0,0 +1,148 @@
+---
+title: "Update Product"
+api: "POST /vendor/products/{id}"
+description: "Stage an update to a product as a change request."
+---
+
+Does not modify the product directly — it stages a pending change request that an operator confirms or declines.
+
+<Note>
+  The endpoint responds with `202 Accepted` and a `product_change` record, not the updated product. Use [Preview Product Change](/rc/references/api/vendor/products/preview-product) to inspect the pending change and [Cancel Product Change](/rc/references/api/vendor/products/cancel-product-change) to withdraw it.
+</Note>
+
+## Path parameters
+
+<ParamField path="id" type="string" required>
+  The product's ID.
+</ParamField>
+
+## Body parameters
+
+<ParamField body="title" type="string">The product's title.</ParamField>
+<ParamField body="subtitle" type="string">The product's subtitle.</ParamField>
+<ParamField body="description" type="string">The product's description.</ParamField>
+<ParamField body="discountable" type="boolean">Whether discounts can apply to the product.</ParamField>
+<ParamField body="is_giftcard" type="boolean">Whether the product is a gift card.</ParamField>
+
+<ParamField body="images" type="object[]">
+  <Expandable title="properties">
+    <ParamField body="id" type="string">Existing image ID to keep.</ParamField>
+    <ParamField body="url" type="string" required>Image URL.</ParamField>
+  </Expandable>
+</ParamField>
+
+<ParamField body="thumbnail" type="string">URL of the product's thumbnail image.</ParamField>
+<ParamField body="handle" type="string">The product's URL handle.</ParamField>
+<ParamField body="external_id" type="string">ID of the product in an external system.</ParamField>
+<ParamField body="type_id" type="string">ID of the product type.</ParamField>
+<ParamField body="collection_id" type="string">ID of the collection the product belongs to.</ParamField>
+
+<ParamField body="categories" type="object[]">
+  <Expandable title="properties">
+    <ParamField body="id" type="string" required>Category ID.</ParamField>
+  </Expandable>
+</ParamField>
+
+<ParamField body="tags" type="object[]">
+  <Expandable title="properties">
+    <ParamField body="id" type="string" required>Tag ID.</ParamField>
+  </Expandable>
+</ParamField>
+
+<ParamField body="options" type="object[]">
+  <Expandable title="properties">
+    <ParamField body="title" type="string" required>Option title.</ParamField>
+    <ParamField body="values" type="string[]" required>Allowed option values.</ParamField>
+  </Expandable>
+</ParamField>
+
+<ParamField body="variants" type="object[]">
+  Variant updates staged with the change.
+  <Expandable title="properties">
+    <ParamField body="id" type="string">Existing variant ID to update.</ParamField>
+    <ParamField body="title" type="string">Variant title.</ParamField>
+    <ParamField body="sku" type="string">Variant SKU.</ParamField>
+    <ParamField body="ean" type="string">EAN barcode.</ParamField>
+    <ParamField body="upc" type="string">UPC barcode.</ParamField>
+    <ParamField body="isbn" type="string">ISBN code.</ParamField>
+    <ParamField body="asin" type="string">Amazon ASIN.</ParamField>
+    <ParamField body="gtin" type="string">GTIN code.</ParamField>
+    <ParamField body="barcode" type="string">Generic barcode.</ParamField>
+    <ParamField body="hs_code" type="string">Harmonized System code.</ParamField>
+    <ParamField body="mid_code" type="string">Manufacturer ID code.</ParamField>
+    <ParamField body="thumbnail" type="string">Variant thumbnail URL.</ParamField>
+    <ParamField body="variant_rank" type="number">Sort rank of the variant.</ParamField>
+    <ParamField body="weight" type="number">Weight of the variant.</ParamField>
+    <ParamField body="length" type="number">Length of the variant.</ParamField>
+    <ParamField body="height" type="number">Height of the variant.</ParamField>
+    <ParamField body="width" type="number">Width of the variant.</ParamField>
+    <ParamField body="origin_country" type="string">Country of origin.</ParamField>
+    <ParamField body="material" type="string">Material of the variant.</ParamField>
+    <ParamField body="metadata" type="object">Custom key-value pairs.</ParamField>
+    <ParamField body="options" type="object">Option title to value mapping.</ParamField>
+  </Expandable>
+</ParamField>
+
+<ParamField body="weight" type="number">Weight of the product.</ParamField>
+<ParamField body="length" type="number">Length of the product.</ParamField>
+<ParamField body="height" type="number">Height of the product.</ParamField>
+<ParamField body="width" type="number">Width of the product.</ParamField>
+<ParamField body="hs_code" type="string">Harmonized System code.</ParamField>
+<ParamField body="mid_code" type="string">Manufacturer ID code.</ParamField>
+<ParamField body="origin_country" type="string">Country of origin.</ParamField>
+<ParamField body="material" type="string">Material of the product.</ParamField>
+<ParamField body="metadata" type="object">Custom key-value pairs.</ParamField>
+<ParamField body="additional_data" type="object">Extra data passed to workflow hooks.</ParamField>
+
+## Response
+
+<ResponseField name="product_change" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The change request's ID.</ResponseField>
+    <ResponseField name="product_id" type="string">ID of the product the change targets.</ResponseField>
+    <ResponseField name="status" type="string">One of `pending`, `confirmed`, `declined`, `canceled`.</ResponseField>
+    <ResponseField name="created_by" type="string">ID of the seller that staged the change.</ResponseField>
+    <ResponseField name="actions" type="object[]">Staged operations, each with `id`, `action` (e.g. `UPDATE`), `details`, `ordering`, and `applied`.</ResponseField>
+    <ResponseField name="internal_note" type="string">Internal note attached to the change.</ResponseField>
+    <ResponseField name="external_note" type="string">Note from the operator, e.g. a revision request.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/vendor/products/prod_01HXYZ' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'x-seller-id: <seller_id>' \
+  -H 'Content-Type: application/json' \
+  -d '{"title": "Acme T-Shirt v2", "description": "Softer fabric."}'
+```
+
+```ts JS Client
+const { product_change } = await client.vendor.products.$id.mutate({
+  $id: "prod_01HXYZ",
+  title: "Acme T-Shirt v2",
+  description: "Softer fabric.",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 202
+{
+  "product_change": {
+    "id": "prodch_01HXYZ",
+    "product_id": "prod_01HXYZ",
+    "status": "pending",
+    "created_by": "sel_01HXYZ",
+    "actions": [
+      {
+        "id": "prodchact_01HXYZ",
+        "action": "UPDATE",
+        "details": { "title": "Acme T-Shirt v2" },
+        "applied": false
+      }
+    ]
+  }
+}
+```
+</ResponseExample>

package/content/references/api/vendor/sellers/create-seller.mdx

@@ -0,0 +1,150 @@
+---
+title: "Create Seller"
+api: "POST /vendor/sellers"
+description: "Register a new seller account with its first member."
+---
+
+Creates a seller account, optionally with an initial address, professional details, and payment details.
+
+<Note>
+  This is a public route — no `Authorization` or `x-seller-id` header is required. When called without an authenticated member, `member_email` is required so the owner member can be created.
+</Note>
+
+## Body parameters
+
+<ParamField body="name" type="string" required>
+  The seller's display name.
+</ParamField>
+
+<ParamField body="email" type="string" required>
+  The seller's contact email.
+</ParamField>
+
+<ParamField body="currency_code" type="string" required>
+  The seller's default currency code (e.g. `usd`).
+</ParamField>
+
+<ParamField body="handle" type="string">
+  Unique handle for the seller's storefront URL.
+</ParamField>
+
+<ParamField body="phone" type="string">
+  The seller's contact phone number.
+</ParamField>
+
+<ParamField body="member_email" type="string">
+  Email for the owner member — required when there is no authenticated member.
+</ParamField>
+
+<ParamField body="first_name" type="string">
+  First name of the owner member.
+</ParamField>
+
+<ParamField body="last_name" type="string">
+  Last name of the owner member.
+</ParamField>
+
+<ParamField body="description" type="string">
+  Description of the seller's store.
+</ParamField>
+
+<ParamField body="address" type="object">
+  The seller's address.
+  <Expandable title="properties">
+    <ParamField body="name" type="string">Address label.</ParamField>
+    <ParamField body="company" type="string">Company name.</ParamField>
+    <ParamField body="first_name" type="string">Contact first name.</ParamField>
+    <ParamField body="last_name" type="string">Contact last name.</ParamField>
+    <ParamField body="address_1" type="string">Street address.</ParamField>
+    <ParamField body="address_2" type="string">Apartment, suite, etc.</ParamField>
+    <ParamField body="city" type="string">City.</ParamField>
+    <ParamField body="country_code" type="string">Two-letter country code.</ParamField>
+    <ParamField body="province" type="string">Province or state.</ParamField>
+    <ParamField body="postal_code" type="string">Postal code.</ParamField>
+    <ParamField body="phone" type="string">Phone number.</ParamField>
+  </Expandable>
+</ParamField>
+
+<ParamField body="professional_details" type="object">
+  The seller's business registration details.
+  <Expandable title="properties">
+    <ParamField body="corporate_name" type="string">Registered corporate name.</ParamField>
+    <ParamField body="registration_number" type="string">Business registration number.</ParamField>
+    <ParamField body="tax_id" type="string">Tax identification number.</ParamField>
+  </Expandable>
+</ParamField>
+
+<ParamField body="payment_details" type="object">
+  The seller's bank account details.
+  <Expandable title="properties">
+    <ParamField body="country_code" type="string">Bank country code.</ParamField>
+    <ParamField body="holder_name" type="string">Account holder name.</ParamField>
+    <ParamField body="bank_name" type="string">Bank name.</ParamField>
+    <ParamField body="iban" type="string">IBAN.</ParamField>
+    <ParamField body="bic" type="string">BIC / SWIFT code.</ParamField>
+    <ParamField body="routing_number" type="string">Routing number.</ParamField>
+    <ParamField body="account_number" type="string">Account number.</ParamField>
+  </Expandable>
+</ParamField>
+
+<ParamField body="metadata" type="object">
+  Custom key-value pairs.
+</ParamField>
+
+<ParamField body="additional_data" type="object">
+  Custom data passed to workflow hooks.
+</ParamField>
+
+## Response
+
+<ResponseField name="seller" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The seller's ID.</ResponseField>
+    <ResponseField name="name" type="string">The seller's name.</ResponseField>
+    <ResponseField name="handle" type="string">The seller's handle.</ResponseField>
+    <ResponseField name="email" type="string">The seller's email.</ResponseField>
+    <ResponseField name="status" type="enum">One of `open`, `pending_approval`, `suspended`, `terminated`.</ResponseField>
+    <ResponseField name="currency_code" type="string">The seller's default currency.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/vendor/sellers' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "name": "Acme Store",
+    "email": "store@acme.com",
+    "currency_code": "usd",
+    "member_email": "owner@acme.com",
+    "first_name": "Jane",
+    "last_name": "Doe"
+  }'
+```
+
+```ts JS Client
+const { seller } = await client.vendor.sellers.mutate({
+  name: "Acme Store",
+  email: "store@acme.com",
+  currency_code: "usd",
+  member_email: "owner@acme.com",
+  first_name: "Jane",
+  last_name: "Doe",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 201
+{
+  "seller": {
+    "id": "sel_01HXYZ",
+    "name": "Acme Store",
+    "handle": "acme-store",
+    "email": "store@acme.com",
+    "status": "pending_approval",
+    "currency_code": "usd"
+  }
+}
+```
+</ResponseExample>

package/content/references/api/vendor/sellers/delete-professional-details.mdx

@@ -0,0 +1,54 @@
+---
+title: "Delete Professional Details"
+api: "DELETE /vendor/sellers/{id}/professional-details"
+description: "Remove the seller's business registration details."
+---
+
+Deletes the seller's professional details and returns the full seller object.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>
+  The seller's ID.
+</ParamField>
+
+## Query parameters
+
+<ParamField query="fields" type="string">
+  Comma-separated fields to include in the response.
+</ParamField>
+
+## Response
+
+<ResponseField name="seller" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The seller's ID.</ResponseField>
+    <ResponseField name="professional_details" type="object">`null` after deletion.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X DELETE 'http://localhost:9000/vendor/sellers/sel_01HXYZ/professional-details' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'x-seller-id: <seller_id>'
+```
+
+```ts JS Client
+const { seller } = await client.vendor.sellers.$id.professionalDetails.delete({
+  $id: "sel_01HXYZ",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 200
+{
+  "seller": {
+    "id": "sel_01HXYZ",
+    "name": "Acme Store",
+    "professional_details": null
+  }
+}
+```
+</ResponseExample>

package/content/references/api/vendor/sellers/invite-seller-member.mdx

@@ -0,0 +1,67 @@
+---
+title: "Invite Seller Member"
+api: "POST /vendor/sellers/{id}/members"
+description: "Invite a new member to the seller's team."
+---
+
+Creates a member invite for the given email and role.
+
+## Path parameters
+
+<ParamField path="id" type="string" required>
+  The seller's ID.
+</ParamField>
+
+## Body parameters
+
+<ParamField body="email" type="string" required>
+  Email address to send the invite to.
+</ParamField>
+
+<ParamField body="role_id" type="enum" required>
+  The role assigned on acceptance. One of `role_seller_administration`, `role_seller_inventory_management`, `role_seller_order_management`, `role_seller_accounting`, `role_seller_support`.
+</ParamField>
+
+## Response
+
+<ResponseField name="member_invite" type="object">
+  <Expandable title="properties">
+    <ResponseField name="id" type="string">The invite's ID.</ResponseField>
+    <ResponseField name="email" type="string">The invited email.</ResponseField>
+    <ResponseField name="role_id" type="string">The role granted on acceptance.</ResponseField>
+    <ResponseField name="accepted" type="boolean">Whether the invite has been accepted.</ResponseField>
+    <ResponseField name="expires_at" type="string">Expiration timestamp.</ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+```bash cURL
+curl -X POST 'http://localhost:9000/vendor/sellers/sel_01HXYZ/members' \
+  -H 'Authorization: Bearer <token>' \
+  -H 'x-seller-id: <seller_id>' \
+  -H 'Content-Type: application/json' \
+  -d '{"email": "teammate@acme.com", "role_id": "role_seller_order_management"}'
+```
+
+```ts JS Client
+const { member_invite } = await client.vendor.sellers.$id.members.mutate({
+  $id: "sel_01HXYZ",
+  email: "teammate@acme.com",
+  role_id: "role_seller_order_management",
+})
+```
+</RequestExample>
+
+<ResponseExample>
+```json 201
+{
+  "member_invite": {
+    "id": "meminv_01HXYZ",
+    "email": "teammate@acme.com",
+    "role_id": "role_seller_order_management",
+    "accepted": false,
+    "expires_at": "2026-01-22T10:00:00.000Z"
+  }
+}
+```
+</ResponseExample>