# Entity definitions

Use these endpoints to manage entity definitions.

## Retrieve all entity definitions

 - [GET /api/entitydefinitions](https://api-docs.sitecore.com/ch/entity-definitions-api/entity-definitions/entitydefinitions.md): Lists all entity definitions.

## Retrieve an entity definition by name

 - [GET /api/entitydefinitions/{name}](https://api-docs.sitecore.com/ch/entity-definitions-api/entity-definitions/entitydefinitionbyname.md): Retrieves an entity definition using its name, with options to include conditional members, load permissions, and exclude light entity definitions.

## Update an entity definition

 - [PUT /api/entitydefinitions/{name}](https://api-docs.sitecore.com/ch/entity-definitions-api/entity-definitions/updateentitydefinition.md): Updates an entity definition with the details provided.

## Delete an entity definition by name

 - [DELETE /api/entitydefinitions/{name}](https://api-docs.sitecore.com/ch/entity-definitions-api/entity-definitions/deleteentitydefinitionbyname.md): Removes the entity definition with a specific name.

## Retrieve an entity definition by name (V2)

 - [GET /api/entitydefinitions/name/{name}](https://api-docs.sitecore.com/ch/entity-definitions-api/entity-definitions/entitydefinitionbynamev2.md): Retrieves an entity definition by its name (V2 endpoint).

## Retrieve an entity definition by ID

 - [GET /api/entitydefinitions/{id}](https://api-docs.sitecore.com/ch/entity-definitions-api/entity-definitions/entitydefinitionbyid.md): Retrieves an entity definition by its ID, with options to include conditional members, load permissions, and exclude light entity definitions.

## Delete an entity definition by ID

 - [DELETE /api/entitydefinitions/{id}](https://api-docs.sitecore.com/ch/entity-definitions-api/entity-definitions/deleteentitydefinitionbyid.md): Removes the entity definition identified by the given ID.

## Calculate the impact of changes to an entity definition

 - [POST /api/entitydefinitions/{name}/impact](https://api-docs.sitecore.com/ch/entity-definitions-api/entity-definitions/calculategraphimpact.md): Submits a modified version of an entity definition and returns an analysis of the impact those changes would have compared to the current definition. Used to preview the effects of schema changes before applying them.