# REST Resource: projects.agent.environments.users.sessions.entityTypes

- [Resource: SessionEntityType](https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes#SessionEntityType)
  - [JSON representation](https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes#SessionEntityType.SCHEMA_REPRESENTATION)
  - [EntityOverrideMode](https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes#SessionEntityType.EntityOverrideMode)
- [Methods](https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes#METHODS_SUMMARY)

## Resource: SessionEntityType

A session represents a conversation between a Dialogflow agent and an end-user. You can create special entities, called session entities, during a session. Session entities can extend or replace custom entity types and only exist during the session that they were created for. All session data, including session entities, is stored by Dialogflow for 20 minutes.

For more information, see the [session entity guide](https://cloud.google.com/dialogflow/docs/entities-session).

| JSON representation |
|---|
| ``` { "name": string, "entityOverrideMode": enum (`https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes#SessionEntityType.EntityOverrideMode`), "entities": [ { object (`https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/Entity`) } ] } ``` |

| Fields ||
|---|---|
| `name` | `string` Required. The unique identifier of this session entity type. Format: `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`, or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>/entityTypes/<Entity Type Display Name>`. If `Environment ID` is not specified, we assume default 'draft' environment. If `User ID` is not specified, we assume default '-' user. `<Entity Type Display Name>` must be the display name of an existing entity type in the same agent that will be overridden or supplemented. |
| `entityOverrideMode` | ``enum (`https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes#SessionEntityType.EntityOverrideMode`)`` Required. Indicates whether the additional data should override or supplement the custom entity type definition. |
| `entities[]` | ``object (`https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/Entity`)`` Required. The collection of entities associated with this session entity type. |

### EntityOverrideMode

The types of modifications for a session entity type.

| Enums ||
|---|---|
| `ENTITY_OVERRIDE_MODE_UNSPECIFIED` | Not specified. This value should be never used. |
| `ENTITY_OVERRIDE_MODE_OVERRIDE` | The collection of session entities overrides the collection of entities in the corresponding custom entity type. |
| `ENTITY_OVERRIDE_MODE_SUPPLEMENT` | The collection of session entities extends the collection of entities in the corresponding custom entity type. Note: Even in this override mode calls to `entityTypes.list`, `entityTypes.get`, `entityTypes.create` and `entityTypes.patch` only return the additional entities added in this session entity type. If you want to get the supplemented list, please call `https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.entityTypes/get#google.cloud.dialogflow.v2.EntityTypes.GetEntityType` on the custom entity type and merge. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes/create` | Creates a session entity type. |
| ### `https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes/delete` | Deletes the specified session entity type. |
| ### `https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes/get` | Retrieves the specified session entity type. |
| ### `https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes/list` | Returns the list of all session entity types in the specified session. |
| ### `https://docs.cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.environments.users.sessions.entityTypes/patch` | Updates the specified session entity type. |