Important considerations
Releases
The eCOS® API is under continuous development, new methods and schemas are added frequently, and occasionally new fields may be added to existing schemas or additional parameters to existing methods.
Existing parameters and fields are not removed or changed to prevent any breaking changes.
Modifying a resource
When updating existing data, you should always send the complete schema with all the existing field values. If you omit fields, they will assume default values and possibly overwrite existing data.
Methods that modify resources should be called shortly after getting the current data to avoid overwriting newer data modified by someone else.
Bulk operations
Methods that allow you to create or modify a resource should always be called sequentially. This will ensure that your requests are processed predictably and that they are not blocked or end in error due to conflicts.
A good rule of thumb is to apply this principle to all POST methods.