Schema properties overview

This table provides a list of schema properties specific to business entities. See Business entity schemas for more information on retrieving these schemas.

Property

Description

More information

x-gw-actions

A list of logical actions that you can take on an entity. This encompasses standard HTTP operations on the element or collection, as well as custom actions.

Cloud API endpoint elements
x-gw-after

Applies to properties of format date or date-time. Indicates a date or date-time that the value must be later than.

Date and date-time fields
x-gw-before

Applies to properties of format date or date-time. Indicates a date or date-time that the value must be earlier than.

Date and date-time fields
x-gw-canonicalCollectionUri

For entities that can be accessed through a Cloud API endpoint, this object contains the URI to the collection endpoint.

Cloud API endpoint elements
x-gw-canonicalElementUri

For entities that can be accessed through a Cloud API endpoint, this object contains the URI to the individual element endpoint.

Cloud API endpoint elements
x-gw-canonicalParent

For entities that can be accessed through a Cloud API endpoint, this object contains the ID of the parent entity.

Cloud API endpoint elements
x-gw-calculatedValues

An object whose keys represent schema properties that have dynamic values. Dynamic values are calculated based on evaluation of static values retrieved through JsonLogic.

Calculated values
x-gw-children

An object containing information about child objects of an entity.

Child entities
x-gw-choices

This property contains typelist values associated with the entity objects. It is included in the schema response when the inlineTypelists query parameter is set to true.

Choice values
x-gw-createOnly

Indicates that a property can be set when creating the entity (during an initial POST), but not modified.

Update restrictions
x-gw-defaultValues

An array of strings that indicate what default views a property will appear in. Possible values include detail, summary, and none.

Cloud API responses
x-gw-dynamicProperties

An object where each key in the map represents a named rule. The values of such keys have a jsonLogic object defining the rules.

Rules
x-gw-entityId

A marker on every schema that corresponds to an entity that contains the id of that entity.

Entity ID
x-gw-filterBy

Applies to typekey properties that have typelists that are filtered by categories from other typelists represented on the same object. This property is an array of schema property names for the filtering typekey properties.

Typekey references
x-gw-forbidden

This property contains an array of one or more values that indicate properties that are forbidden for use in a particular context. Often used within an x-gw-rules object to identify fields that cannot be used in certain situations.

x-gw-localizations

When the

includeLocalizations query parameter is set to true, this property is included in the schema to show localized versions of strings for every installed language.
Localizations
x-gw-maximum

Used to represent a maximum value for a property that is not a standard JSON integer or decimal, such as a gw-bigdecimal or MonetaryAmount object.

Numeric values
x-gw-minimum

Used to represent a minimum value for a property that is not a standard JSON integer or decimal, such as a gw-bigdecimal or MonetaryAmount object.

Numeric values
x-gw-patchOnly

Indicates that the value can be set only during updates (PATCH requests), not during the initial creation (POST request).

Update restrictions
x-gw-precision

The precision of a fixed-point decimal value (the total number of digits allowed in a number).

Numeric values
x-gw-reference-schema

The name of the schema definition associated with a given type when a property is a reference (such as SimpleReference).

References
x-gw-referenceType

The name of the referenced entity type when a property is a reference (such as SimpleReference).

References
x-gw-requiredForCreate

An array of property names for properties whose values must be specified as part of POST requests to create a new entity.

Required properties
x-gw-requiredForValidation

This property identifies fields that are required for a particular entity to be valid. A typical use case is to define required fields in an address.

x-gw-resourceReference

A marker attached to schema definitions such as SimpleReference that indicates that the schema represents a reference to another entity.

References
x-gw-rules

This property contains a jsonLogic attribute where you can apply conditional rules to various schema elements.

x-gw-scale

The scale of a fixed-point decimal value (the number of digits allowed to the right of the decimal point).

Numeric values
x-gw-sortOrder

The sequence number of coverable fields defined in APD.

x-gw-typelist

The name of the typelist when the property is a reference to a TypeKeyReference.

Typekey references