Schema
Description of entities, request and response objects.
A schema describes Entity, Request, Response, etc objects. Specific properties data type, required fields, filter groups, sort options and describes special cases. Schema is split into two blocks - the first block describes individual fields and the second shows the JSON format.
Description
The example below shows some object properties with descriptions.
id long
Entity ID - cannot be null in PUT/PATCH methods
📶 EQUALS,ENUM 🔽 NONE
_cloudId integer
Cloud ID
🔽 NONE
_eetSubjectId long?
EET Subject ID
📶 EQUALS,ENUM 🔽 NONE
deleted boolean
Entity deleted
📶 EQUALS,ENUM 🔽 NONE
externalId string?
External ID
📶 EQUALS,ENUM 🔽 NONE
flags integer
Entity flags - see Flags
📶 BITS 🔽 NONE
name string(180)
Entity name
📶 EQUALS,STRING 🔽 BOTH
All internal IDs have an underscore prefix, f.e._cloudId.
All numeric properties are represented as string in JSON.
📶 filter groups allowed for a field 🔽 sort options available for a field
Validated properties
Properties of data types followed by question mark (?) are optional. All other properties are mandatory. In special cases there can be a note mark with a number.
Property data type
Descriptiion
name string
NOT NULL
externalId string?
OPTIONAL
id long [1]
Special case with group 1 description below
firstName string? [2]
Special case with group 2 description below
lastName string? [2]
Special case with group 2 description below
companyName string? [2]
Special case with group 2 description below
Properties with [number] have special description below.
[1] ID cannot be null in PUT/PATCH methods [2] One of properties firstName, lastName, companyName cannot be BLANK / EMPTY but other can be EMPTY.
Value
Description
string(400)
String with maximum length of 400
string(200,250)
String length between 200 to 250
string[]
Array of strings
string[1,100]
Array of strings with item count between 1 to 100
string[](1000)
Array of strings with maximum length of 1000 in joined string (with separators)
Last updated