# Entities

The Entities endpoint is used to manage entities.  

## Retrieve an entity using its ID

 - [GET /api/entities/{id}](https://api-docs.sitecore.com/ch/entities-api/entities/entitybyid.md): Retrieves an entity using its ID and loads related data, including entity properties, member groups, renditions, permissions, and so on. You can also specify cultures for multi-language support.

## Update an entity using its ID

 - [PUT /api/entities/{id}](https://api-docs.sitecore.com/ch/entities-api/entities/updateentity.md): Updates an entity with the new details provided, including properties, relations, associated members and groups, and so on. Properties or relations not included in the request will be set to null.

## Delete an entity using its ID

 - [DELETE /api/entities/{id}](https://api-docs.sitecore.com/ch/entities-api/entities/deleteentity.md): Deletes an entity with the specified ID.

## Retrieve an entity using its identifier

 - [GET /api/entities/identifier/{identifier}](https://api-docs.sitecore.com/ch/entities-api/entities/entitybyidentifier.md): Retrieves an entity with the specified identifier, including related data such as properties, member groups, renditions, permissions, and so on.

## Update an entity using its identifier

 - [PUT /api/entities/identifier/{identifier}](https://api-docs.sitecore.com/ch/entities-api/entities/updateentitybyidentifier.md): Updates an entity with the new details provided, including properties, relations, associated members and groups, and so on. Properties or relations not included in the request will be set to null.

## Delete an entity using its identifier

 - [DELETE /api/entities/identifier/{identifier}](https://api-docs.sitecore.com/ch/entities-api/entities/deleteentitybyidentifier.md): Deletes an entity with the specified identifier.

## Retrieve a list of all entities for a specific entity definition

 - [GET /api/entitydefinitions/{name}/entities](https://api-docs.sitecore.com/ch/entities-api/entities/entitiesbydefinition.md): Lists all entities for the specified entity definition.

## Create an entity

 - [POST /api/entities](https://api-docs.sitecore.com/ch/entities-api/entities/addentity.md): Creates an entity with the specified details, including associated members and groups. The link to the associated Entity Definition Resource is required. The self property is ignored and can be omitted.   If the request body contains an id, the request is treated as a possible UPSERT. If the id is omitted and only an identifier is provided, the request returns a conflict instead of updating the existing entity. The request then checks for the existence of the entity and if the response is positive, it updates the entity based on the provided body elements. When an id is present, the header contains the same Location property as with a normal POST response. When an identifier is used, the header contains an X-Global-Identifier property with the updated identifier as its value.   Use the Upload API to upload assets to Content Hub. {% admonition type="info" name="Note" %}It is not possible to set relations while creating an entity unless the relations are nested. Additionally, this functionality is available only through the REST API and not through the Web Client SDK. For non-nested relations one call is made for each relation that is updated. {% /admonition %}

## Retrieve renditions for a specified entity

 - [GET /api/entities/{entityId}/v2.0/renditions](https://api-docs.sitecore.com/ch/entities-api/entities/getrenditionsv2.md): Retrieves information about all renditions that exist for a specified entity, including their gateway links and delivery links.

## Retrieve renditions for a specified entity

 - [POST /api/entities/{entityId}/v2.0/renditions](https://api-docs.sitecore.com/ch/entities-api/entities/getfilteredrenditionsv2.md): Retrieves information about renditions that exist for a specified entity, including their gateway links and delivery links. Renditions can be filtered by area of use or by their rendition link name, or both.

## Retrieve the count of user renditions for a specified entity

 - [GET /api/entities/{entityId}/v2.0/renditions/GetUserRenditionsCount](https://api-docs.sitecore.com/ch/entities-api/entities/getuserrenditioncountv2.md): Retrieves the count of user renditions for a specified entity.