---
title: "Add or change the promotion property schemas"
method: PATCH
path: "/v1/tenants/{tenantId}/promotionPropertySchemas"
tags: ["TenantCommand"]
---

# Add or change the promotion property schemas

`PATCH /v1/tenants/{tenantId}/promotionPropertySchemas`

Add or change the promotion property schemas

## Path parameters

- `tenantId` string, required

## Request body

- TenantcommandMergePromotionPropertySchemas
  - `propertySchemas` SchemaPropertySchema[]
    - `name` string
    - `description` string
    - `stringProperty` SchemaStringPropertySchema
      - `validStrings` string[]
    - `multiStringProperty` SchemaMultiStringPropertySchema
      - `validStrings` string[]
    - `numberProperty` SchemaNumberPropertySchema
      - `min` number, double
      - `max` number, double
    - `timestampProperty` SchemaTimestampPropertySchema
      - `earliest` string, date-time
      - `latest` string, date-time
    - `propertyVisibility` 'DEPRECATED' | 'VISIBLE' | 'INCLUDE_ON_CREATE'
    - `propertyCaching` 'CACHED' | 'NOT_CACHED'
    - `id` string

## Response `200`

A successful response.

- TenantcommandserviceTransactionCommittedResponse
  - `requestId` string
  - `tenantId` string
  - `availableCommands` TenantcommandAvailableCommand[]
    - `command` 'CREATE' | 'ACTIVATE' | 'DEACTIVATE' | 'ARCHIVE' | 'SET_METADATA' | 'SET_PROMOTION_PROPERTY_SCHEMA' | 'SET_CUSTOMER_PROPERTY_SCHEMA' | 'MERGE_AMOUNT_REWARD_TYPES' | 'MERGE_UNIT_REWARD_TYPES' | 'MERGE_PROMOTION_PROPERTY_SCHEMAS' | 'MERGE_CUSTOMER_PROPERTY_SCHEMAS' | 'MERGE_SESSION_PROPERTY_SCHEMAS' | 'SET_LICENSE_TERMS'
    - `url` string
    - `httpMethod` 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'
  - `events` TenanteventEvent[]
    - `revision` integer
    - `created` TenanteventCreated
    - `activated` TenanteventActivated
    - `deactivated` TenanteventDeactivated
    - `archived` TenanteventArchived
    - `metadataSet` TenanteventMetadataSet
      - `name` string
      - `description` string
      - `timezoneDesignatorIana` string
      - `firstDayOfWeek` 'SUNDAY' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY'
    - `amountRewardTypesMerged` EventAmountRewardTypesMerged
      - `amountRewardTypes` RewardAmountRewardType[]
        - `name` string
        - `description` string
        - `imageUrl` string
        - `colorRgb` integer
        - `visibility` 'VISIBLE' | 'DEPRECATED'
        - `amountConstraint` RewardAmountConstraint
          - `minAmountCents` integer
          - `maxAmountCents` integer
        - `id` string
    - `unitRewardTypesMerged` EventUnitRewardTypesMerged
      - `unitRewardTypes` RewardUnitRewardType[]
        - `name` string
        - `description` string
        - `imageUrl` string
        - `visibility` 'VISIBLE' | 'DEPRECATED'
        - `unitConstraint` RewardUnitConstraint
          - `minUnitCount` integer
          - `maxUnitCount` integer
        - `id` string
    - `promotionPropertySchemasMerged` EventPromotionPropertySchemasMerged
      - `propertySchemas` SchemaPropertySchema[]
        - `name` string
        - `description` string
        - `stringProperty` SchemaStringPropertySchema
          - `validStrings` string[]
        - `multiStringProperty` SchemaMultiStringPropertySchema
          - `validStrings` string[]
        - `numberProperty` SchemaNumberPropertySchema
          - `min` number, double
          - `max` number, double
        - `timestampProperty` SchemaTimestampPropertySchema
          - `earliest` string, date-time
          - `latest` string, date-time
        - `propertyVisibility` 'DEPRECATED' | 'VISIBLE' | 'INCLUDE_ON_CREATE'
        - `propertyCaching` 'CACHED' | 'NOT_CACHED'
        - `id` string
    - `customerPropertySchemasMerged` EventCustomerPropertySchemasMerged
      - `propertySchemas` SchemaPropertySchema[]
        - `name` string
        - `description` string
        - `stringProperty` SchemaStringPropertySchema
          - `validStrings` string[]
        - `multiStringProperty` SchemaMultiStringPropertySchema
          - `validStrings` string[]
        - `numberProperty` SchemaNumberPropertySchema
          - `min` number, double
          - `max` number, double
        - `timestampProperty` SchemaTimestampPropertySchema
          - `earliest` string, date-time
          - `latest` string, date-time
        - `propertyVisibility` 'DEPRECATED' | 'VISIBLE' | 'INCLUDE_ON_CREATE'
        - `propertyCaching` 'CACHED' | 'NOT_CACHED'
        - `id` string
    - `licenseTermsSet` EventLicenseTermsSet
      - `customerPropertiesCachingQuota` integer
    - `sessionPropertySchemasMerged` EventSessionPropertySchemasMerged
      - `propertySchemas` SchemaPropertySchema[]
        - `name` string
        - `description` string
        - `stringProperty` SchemaStringPropertySchema
          - `validStrings` string[]
        - `multiStringProperty` SchemaMultiStringPropertySchema
          - `validStrings` string[]
        - `numberProperty` SchemaNumberPropertySchema
          - `min` number, double
          - `max` number, double
        - `timestampProperty` SchemaTimestampPropertySchema
          - `earliest` string, date-time
          - `latest` string, date-time
        - `propertyVisibility` 'DEPRECATED' | 'VISIBLE' | 'INCLUDE_ON_CREATE'
        - `propertyCaching` 'CACHED' | 'NOT_CACHED'
        - `id` string

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/optimove/apis/optimove-api.md) · [All operations](https://skmtc.net/optimove/apis/optimove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/optimove/optimove-api/revisions/fc55c5b1bec5/schema)