Skip to main content
All endpoint requests and responses for a given entity use the same model structure, with some fields being either read-only or editable depending on the method. If a property is not editable for the endpoint in question, it will be ignored. For example, if the following organization entity body is used with the Create Organization endpoint, then the id property will be ignored and a new organization will be created with a new id and “New organization” as the name. 
{
  "id": "4b8360d00000000000000001",
  "name": "New organization"
}
Using this approach, an entity can be created or updated using the same model read from a read entity call, as read-only fields will not be overwritten by changes made to the create or update body. If a property that is not present on the model is included in a create or update request, then the request body will be considered invalid and an error will be returned.