Skip to content

Create a metafield definition validation

View as Markdown
post /rest/api/metafield_definition_validations

Creates a MetafieldDefinitionValidation resource.

Adds a validation rule to a metafield definition. Reference the metafieldDefinition, the validation name (type) and its value. The rule must be compatible with the definition’s type, otherwise it is rejected with 422.

Headers

NameTypeRequiredDescription
X-Flowkiwi-Organization-IdstringrequiredThe organization the request acts as. Determines the identity, permissions and ownership applied when reading or modifying data on the instance.

Request body

PropertyTypeRequiredDescription
metafieldDefinitionstringrequiredThe metafield definition this validation belongs to.
namestringrequiredThe type of validation rule.
valuestringrequiredThe validation parameter value. Format depends on the validation type.

Response

201 - MetafieldDefinitionValidation resource created

PropertyTypeRequiredDescription
@contextobject-
@idstringrequired
@typestringrequired
idstring-The resource's unique identifier (UUID).
metafieldDefinitionstringrequiredThe metafield definition this validation belongs to
namestringrequiredThe type of validation rule
valuestringrequiredThe validation parameter value. Format depends on the validation type.

Errors

400 - Invalid input

PropertyTypeRequiredDescription
@contextobject-
@idstringrequired
@typestringrequired
titlestring | null-A short, human-readable summary of the problem.
detailstring | null-A human-readable explanation specific to this occurrence of the problem.
statusnumber | null-
instancestring | null-A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
typestring-A URI reference that identifies the problem type

403 - Access denied. The caller is missing one or more identity permissions required for this operation.

Content-Type: application/problem+json

PropertyTypeRequiredDescription
@contextobject-
@idstringrequired
@typestringrequired
typestring-
titlestring-
statusinteger-
detailstring-
missingPermissionsstring[]-Identity permissions that the caller is missing for this operation. Present only when the 403 is caused by a denied identity:* permission.

422 - An error occurred

PropertyTypeRequiredDescription
@contextobject-
@idstringrequired
@typestringrequired
statusinteger-
violationsobject[]-
Show violations fields
PropertyTypeRequiredDescription
propertyPathstringrequiredThe property path of the violation
messagestringrequiredThe message associated with the violation
codestring-The code of the violation
hintstring-An extra hint to understand the violation
payloadobject-The serialized payload of the violation
detailstring-
typestring-
titlestring | null-
instancestring | null-