> ## Documentation Index
> Fetch the complete documentation index at: https://developer.mindbridge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Entity model

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.

```json theme={null}
{
  "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.
