# Guidelines

The MyLuxura REST API can be used to fetch and update content on MyLuxura.

{% hint style="warning" %}
**Rules of thumb**\
\- Perform as little requests as required;\
\- Don't mutate fields if you you're not sure what they do;\
\- Don't create more documents than necessary;\
\- Remove documents that are absolete or created by mistake.
{% endhint %}

## Definitions

Below you will find a list of definitions used in this documentation. 

| Definition | Description                                                                                                                       |                                                                               |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| `resource` | Group of the same type of documents, e.g. `users`, `equipment.`                                                                   |                                                                               |
| `index`    | Synonym for `resource.`                                                                                                           |                                                                               |
| `document` | An instance of a resource with its own guid.                                                                                      | [more details](https://docs.vedicium.io/myluxura/rest-api/overview/documents) |
| `GUID`     | The 'Globally Unique IDentifier' of a document.                                                                                   |                                                                               |
| `token`    | The [personal access token](https://docs.vedicium.io/myluxura/master#personal-access-token) created to authenticate with the API. |                                                                               |