Skip to main content
PATCH
/
v1
/
storefronts
/
{storefrontId}
/
products
/
{productId}
Update product
curl --request PATCH \
  --url https://api.mareaalcalina.com/v1/storefronts/{storefrontId}/products/{productId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "price": 1,
  "description": "<string>",
  "salePrice": 1,
  "category": "<string>",
  "subcategory": "<string>",
  "imageUrl": "<string>",
  "thumbnailUrl": "<string>",
  "sku": "<string>",
  "slug": "<string>",
  "position": 123,
  "cartProduct": true,
  "hide": true,
  "stock": 123,
  "tags": [
    "<string>"
  ],
  "extraProductsCategory": [
    {
      "title": "<string>",
      "obligatory": true,
      "multipleOption": true,
      "maxOptions": 123,
      "minOptions": 123,
      "extraProducts": [
        {
          "title": "<string>",
          "price": 1,
          "available": true,
          "stock": 123
        }
      ]
    }
  ]
}
'
{
  "product": {
    "id": "prd_abc123",
    "title": "<string>",
    "description": "<string>",
    "price": 123,
    "salePrice": 123,
    "category": "<string>",
    "subcategory": "<string>",
    "imageUrl": "<string>",
    "thumbnailUrl": "<string>",
    "sku": "<string>",
    "slug": "<string>",
    "position": 123,
    "cartProduct": true,
    "hide": true,
    "stock": 123,
    "tags": [
      "<string>"
    ],
    "extraProductsCategory": [
      {
        "title": "<string>",
        "obligatory": true,
        "multipleOption": true,
        "maxOptions": 123,
        "minOptions": 123,
        "extraProducts": [
          {
            "title": "<string>",
            "price": 1,
            "available": true,
            "stock": 123
          }
        ]
      }
    ],
    "imageProcessingPending": true,
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.mareaalcalina.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Marea API key. mk_dev_* keys are developer-scoped (bootstrap, list users, register webhook). mk_user_* keys are user-scoped (manage that one user's storefronts/products).

Headers

Idempotency-Key
string

Optional client-supplied key. Replays of the same key within 24h return the original response. Recommended for POSTs that mutate billing/inventory.

Maximum string length: 200
Example:

"idem_b2a9f5b9-3e0c-4a5e-b3c2-7a4ce85a6b21"

Accept-Language
string

BCP-47 locale tag for localized error messages (es, en, pt). Defaults to es.

Example:

"es-MX"

Path Parameters

storefrontId
string
required
productId
string
required

Body

application/json

Request body.

Agent-facing product input shape. Mutability rule §6.18.1.1: every field PATCHable post-create.

title
string
required
Required string length: 1 - 200
price
number
required
Required range: x >= 0
description
string | null
salePrice
number | null
Required range: x >= 0
category
string | null
subcategory
string | null
imageUrl
string<uri> | null
thumbnailUrl
string<uri> | null
sku
string | null
slug
string | null
position
integer | null
cartProduct
boolean | null
hide
boolean | null
stock
integer | null
tags
string[] | null
extraProductsCategory
object[] | null

Response

Success.

product
object
required