---
title: "Assign commerce item business scope"
method: PATCH
path: "/commerce/items/{itemId}/property"
tags: ["Commerce"]
---

# Assign commerce item business scope

`PATCH /commerce/items/{itemId}/property`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/commerce/items/{itemId}/property`
- Auth: HTTP bearer

Requires `commerce:items:write`. Send `propertyId` to scope the item to one active business, or `null`/empty body to make it global.

## Path parameters

- `itemId` string, required

## Request body

- CommerceItemPropertyUpdateRequest
  - `propertyId` string, nullable

## Response `200`

Commerce item business scope updated

- CommerceItemPropertyResponse
  - `itemId` string, required
  - `scope` 'global' | 'property', required
  - `propertyId` string

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)