Skip to content

Change or archive a custom field

PATCH
/products/{productId}/custom-fields/{id}
curl --request PATCH \
--url https://api.motenya.app/v1/products/example/custom-fields/example \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "label": "example", "type": "text", "options": [ { "key": "example", "label": "example", "archived": true } ], "required": true, "filterable": true, "onCard": true, "position": 1, "archived": true }'

Requires crm:configure.

productId
required
string
>= 1 characters <= 64 characters
id
required
string
>= 1 characters <= 64 characters
Media typeapplication/json
object
label
string | null
>= 1 characters <= 100 characters
type

Only widening changes: number → text, select → multiselect.

string | null
Allowed values: text number money date boolean select multiselect url
options
Array<object> | null
<= 200 items
object
key

Omit for a new option: derived from the label.

string | null
<= 64 characters
label
required
string
>= 1 characters <= 100 characters
archived
boolean | null
required
boolean | null
filterable
boolean | null
onCard
boolean | null
position
integer | null
<= 100000
archived
boolean | null

Success

Media typeapplication/json
object
id
required
string
>= 1 characters <= 64 characters
entity
required
string
Allowed values: contact client catalog_item order subscription
key
required
string
label
required
string
type
required
string
Allowed values: text number money date boolean select multiselect url
options
required
Array<object>
object
key
required
string
label
required
string
archived
required
boolean
required
required
boolean
filterable
required
boolean
onCard
required
boolean
position
required
integer
archived
required
boolean
createdAt
required
string
updatedAt
required
string
key
additional properties

Example

{
"entity": "contact",
"type": "text"
}

Invalid request

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Missing, invalid, revoked or expired API key

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Missing scope, API turned off, published article without publish scope, or account suspended

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Not found, or outside the knowledge bases this key may use

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Slug or translation already exists

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Rejected by validation (e.g. unknown language or category)

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Rate limited; see Retry-After

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string

Example

{
"error": {
"code": "SLUG_TAKEN"
}
}

Internal error