Update a product

PATCH

products

{id}

curl --request PATCH \
  --url https://api.vexioncards.one/v1/products/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "price_minor": 390,
  "tags": [
    "coffee",
    "hot",
    "bestseller"
  ]
}
'

{
  "id": "prd_01HW9R7T2CD8N8MTX1RVPRDFW1",
  "object": "product",
  "location_id": "loc_01HW9R4P2ZK7N8MTX1RVLOCS01",
  "name": "Flat White",
  "sku": "FW-12",
  "category": "drinks",
  "tags": [
    "coffee",
    "hot",
    "bestseller"
  ],
  "price_minor": 390,
  "source": "api",
  "pos_ref": null,
  "is_active": true,
  "created_at": 1750000000,
  "updated_at": 1751500000
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "request_too_large",
    "message": "The request body exceeds the maximum allowed size.",
    "doc_url": "https://vexioncards.mintlify.site/api-reference/errors#request_too_large",
    "request_id": "req_5f8b2c4a9e1d3"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "An internal error occurred. The request may be retried with the same Idempotency-Key.",
    "doc_url": "https://vexioncards.mintlify.site/api-reference/errors#internal_error",
    "request_id": "req_5f8b2c4a9e1d3"
  }
}

Authorizations

Authorization

string

header

required

Your secret API key as a Bearer token: Authorization: Bearer vxn_sk_.... Keys are created and scoped in the dashboard - see Authentication.

Headers

Idempotency-Key

string

Recommended on PATCH and DELETE for safe retries.

Required string length: 8 - 255

Path Parameters

string

required

Product identifier (prd_ prefix).

Pattern: ^prd_[A-Za-z0-9]+$

Body

application/json

Editable fields. pos_ref is never editable (owned by the sync); location_id is immutable (create a new entry at the other location). Archive with is_active: false - there is no DELETE.

name

New display name - plain string or per-language object (SET semantics on the whole value).

Required string length: 1 - 200

Example:

"Flat White"

sku

string | null

New correlation key (unique per location) - or null to clear.

Required string length: 1 - 64

Response

Updated product.

A catalog entry for correlating transaction line items to real products. Catalogs are per-location (each location can run a different POS with a different menu), unified under the organization: list org-wide, filter by location_id.

This is a loyalty correlation catalog, not an inventory system - no variants, modifiers, or stock levels.

string

required

Product identifier, prd_ prefix. Stable forever - line items resolve to it.

Pattern: ^prd_[A-Za-z0-9]+$

Example:

"prd_01HW9R7T2CD8N8MTX1RVPRDFW1"

object

string

required

Always "product".

Allowed value: "product"

location_id

string

required

The location this catalog entry belongs to. The same drink sold at two locations is two Product records (each mapped to its own POS).

Pattern: ^loc_[A-Za-z0-9]+$

Example:

"loc_01HW9R4P2ZK7N8MTX1RVLOCS01"

name

required

Display name - plain string or per-language object, the same localization pattern as Card.name. POS-synced entries arrive with the till's single-language name; supply per-language names on manual/API entries when your audience is multilingual (border stores, tourist areas). Notifications and future product-facing surfaces resolve the name in the customer's language.

Required string length: 1 - 200

Example:

"Flat White"

source

string

required

Where this catalog entry originated. Known values: pos (synced from the location's connected POS), manual (dashboard), api (created via POST /v1/products). Server-stamped - treat as an open set.

Example:

"pos"

is_active

boolean

required

False = archived (delisted from the POS or manually retired). Archived products stay resolvable on historical line items - there is no hard delete.

Example:

true

created_at

integer

required

Unix seconds.

Example:

1750000000

sku

string | null

Your stable key, unique per location (two locations may both use FW-12). This is what transaction line items correlate on.

Required string length: 1 - 64

Example:

"FW-12"

tags

string[]

Merchant-owned filing aid, and part of the search haystack alongside the name. NEVER populated by POS sync: no POS system sends tags, so a source: "pos" entry arrives untagged. You can tag one yourself with PATCH /v1/products/{id} (tags are an overlay field, unlike pos_ref and source, which sync owns), and it becomes findable by that tag immediately. Sending [] clears them and removes them from the search haystack.

Example:

["coffee", "hot"]

price_minor

integer | null

Reference price in minor units. Informational - the POS bill is authoritative at transaction time.

Required range: x >= 0

Example:

350

pos_ref

object | null

The POS mapping for this location's adapter. Read-only, owned by the sync - never editable via API. Null for manual/API entries. The POS vendor name is never surfaced.

Show child attributes

Example:

null

updated_at

integer

Unix seconds of last change.

Example:

1750000000

curl --request PATCH \
  --url https://api.vexioncards.one/v1/products/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "price_minor": 390,
  "tags": [
    "coffee",
    "hot",
    "bestseller"
  ]
}
'

{
  "id": "prd_01HW9R7T2CD8N8MTX1RVPRDFW1",
  "object": "product",
  "location_id": "loc_01HW9R4P2ZK7N8MTX1RVLOCS01",
  "name": "Flat White",
  "sku": "FW-12",
  "category": "drinks",
  "tags": [
    "coffee",
    "hot",
    "bestseller"
  ],
  "price_minor": 390,
  "source": "api",
  "pos_ref": null,
  "is_active": true,
  "created_at": 1750000000,
  "updated_at": 1751500000
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "request_too_large",
    "message": "The request body exceeds the maximum allowed size.",
    "doc_url": "https://vexioncards.mintlify.site/api-reference/errors#request_too_large",
    "request_id": "req_5f8b2c4a9e1d3"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "retry_after": 5,
    "param": "<string>",
    "request_id": "<string>",
    "doc_url": "<string>",
    "field_errors": [
      {
        "param": "<string>",
        "code": "<string>",
        "message": "<string>",
        "expected_currency": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "An internal error occurred. The request may be retried with the same Idempotency-Key.",
    "doc_url": "https://vexioncards.mintlify.site/api-reference/errors#internal_error",
    "request_id": "req_5f8b2c4a9e1d3"
  }
}

API Reference

MCP server

Customers

Cards

Transactions

Products

Notifications

Locations

Team members

Custom fields

Events

Webhook endpoints

API keys

Organization

Icons

API Reference

Authorizations

Headers

Path Parameters

Body

Response