Skip to main content
POST
/
api
/
property-definitions
/
Create Property Definition
curl --request POST \
  --url https://api.merchantops.ai/api/property-definitions/ \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "id": "<string>",
  "key": "<string>",
  "name": "<string>",
  "type": {},
  "aiCanAddANewValue": true,
  "aiMatchingGuidance": "<string>",
  "attributeConstraint": "<string>",
  "category": "<string>",
  "createdAt": "<string>",
  "createdBy": "<string>",
  "description": [
    {}
  ],
  "display_group": "<string>",
  "display_order": 0,
  "enrichment_config": {},
  "inputHint": "<string>",
  "isActive": true,
  "isFacetable": false,
  "isMultiValue": false,
  "isRequired": false,
  "isSearchable": false,
  "isVisibleInStorefront": true,
  "is_common": false,
  "is_entry_field": false,
  "is_system": false,
  "label": [
    {}
  ],
  "lastModifiedAt": "<string>",
  "lastModifiedBy": "<string>",
  "level": "<string>",
  "mustBeAccurateToAssign": false,
  "prompt_name": "<string>",
  "scope": "catalog",
  "ui_widget": "text_input",
  "valueCount": 0,
  "visibility": "list_and_detail"
}

Headers

​
authorization
string | null
​
X-Organization-ID
string | null

Cookies

​
stytch_session
string | null

Body

application/json

The body is of type Prop Data · object.

Response

Successful Response

Response model for a single PropertyDefinition.

​
id
string
required

MongoDB ObjectId as string

​
key
string
required
​
name
string
required
​
type
Type · object
required
​
aiCanAddANewValue
boolean
default:true
​
aiMatchingGuidance
string | null
​
attributeConstraint
string | null
​
category
string | null
​
createdAt
string | null
​
createdBy
string | null
​
description
Description · object[] | null
​
display_group
string | null
​
display_order
integer | null
default:0
​
enrichment_config
Enrichment Config · object
​
inputHint
string | null
​
isActive
boolean
default:true
​
isFacetable
boolean
default:false
​
isMultiValue
boolean
default:false
​
isRequired
boolean
default:false
​
isSearchable
boolean
default:false
​
isVisibleInStorefront
boolean
default:true
​
is_common
boolean
default:false

Common property flag

​
is_entry_field
boolean
default:false

Entry field flag

​
is_system
boolean
default:false

System property flag

​
label
Label · object[]
​
lastModifiedAt
string | null
​
lastModifiedBy
string | null
​
level
string | null
​
mustBeAccurateToAssign
boolean
default:false
​
prompt_name
string | null
​
scope
string
default:catalog

Scope: 'catalog' or 'lakehouse'

​
ui_widget
string
default:text_input
​
valueCount
integer
default:0

Number of enum values

​
visibility
string
default:list_and_detail