--- title: "Key Concepts" slug: "key-concepts" updated: 2026-10-24T10:08:55Z published: 2026-10-24T10:08:55Z canonical: "documentation.decisions.com/key-concepts" --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt > Use this file to discover all available pages before exploring further. # Key Concepts # Key Concepts Understand key concepts prior to preparing your ProcessMaker REST API requests. Understand the following key concepts from which to better understand what the [entity object](/processmaker/docs/key-concepts#entity-object) is prior to preparing your REST API requests: - [Entity type](/processmaker/docs/key-concepts#entity-type) - [Entity](/processmaker/docs/key-concepts#entity) - [Attributes](/processmaker/docs/key-concepts#attributes) ### Entity Type An entity type describes a class of objects and their attributes. For example: a **Person** can be an entity type. ### Entity An entity is an instance of an entity type / a single object. For example: **John Doe** is an instance of Person. ### Attributes Attributes are characteristics that pertain to an entity type. An attribute represents a small piece of information about an entity. For example, the Person entity type could have an attribute called **date of birth**. ## Entity Object The ProcessMaker REST API represents an entity object as the following endpoints based on these key concepts: - [Type](/processmaker/docs/key-concepts#type) - [Attributes](/processmaker/docs/key-concepts#attributes-1) - [Relations](/processmaker/docs/key-concepts#relations) Below is an example of an entity object of an entity of type file you may reference in the representations that follow. ```json {  "type": "file",  "attributes": {    "createdAt": "2019-11-19T13:37:46.824+0000",    "createdBy": null,    "documentType": "NONE",    "modifiedAt": "2019-11-19T13:37:46.824+0000",    "name": "Welcome to IDP.docx",    "modifiedBy": null,    "checkedOutBy": null,    "id": "bd37f241-7b05-4ba8-ae0b-ab844daafd36",    "content": null  },  "relations": {    "parent": "/api/rest/folder/5f97858b-26e3-4180-80c4-25b176cbc35f"  } } ``` ### Type Type is a string that represents the type of an entity. ### Attributes Attributes are JSON key-value pairs store data that pertain to an entity. ### Relations Relations is a JSON object that represents references to and from a specified entity object. For example, a parent entity is defined by its child JSON objects. Inversely, the child JSON objects are collectively defined by its parent. Below is an example of a relation. ```json "relations": {            "parent": "/api/rest/folder/b9072a85-2214-4f55-9ca6-e29ad59167a1",            "files": "/api/rest/folder/97869a7d-946a-4f7c-b612-34f5e5ab02ce/files"        }, ```