The API has two styles or approaches - 'Simple' and JSONAPI
'Simple' apis are intended for systems to easily perform tasks, such as creating cardfile, by submitting a simple JSON document.
The JSONAPI conformant apis are intended for more complex options, including updating objects in Jim2. These APIs are modelled on the JSON:API version 1.1 specification
The API also implements the atomic operations extension. Some of the 'simple' api endpoints can be used within an atomic operation, however, the 'simple' api endpoints do not support dependencies between operations (eg creating a cardfile and adding a job for that cardfile in one atomi operation). JSONAPI endpoints have to be used in this scenario.